Failed to extract signature
8 changed files with 241 additions and 13 deletions
Split View
Diff Options
-
+2 -3composer.json
-
+58 -4composer.lock
-
+4 -0controllers/main.php
-
+150 -0data/static-maps.md
-
+5 -0public/assets/styles.css
-
+6 -1views/index.php
-
+0 -5views/layout.php
-
+16 -0views/static-maps.php
+ 2
- 3
composer.json
View File
+ 58
- 4
composer.lock
View File
+ 4
- 0
controllers/main.php
View File
+ 150
- 0
data/static-maps.md
View File
| @ -0,0 +1,150 @@ | |||
| ## Base URL | |||
| The base URL of the static maps API is: | |||
| ``` | |||
| https://atlas.p3k.io/map/img | |||
| ``` | |||
| You can run your own instance of this for better performance. | |||
| ## Parameters | |||
| Parameters can be included in either the query string or in the POST body. | |||
| * `zoom` - optional - Set the zoom level for the map. If not specified, a zoom level will be chosen that contains all markers on the map. | |||
| * `maxzoom` - optional - When a zoom level is chosen automatically, this sets an upper limit on the zoom level that will be chosen. Useful if you know your basemaps don't have imagery past a certain zoom level. | |||
| * `width` - default 300 - Width in pixels of the final image | |||
| * `height` - default 300 - Height in pixels of the final image | |||
| * `basemap` - default "streets" - Select the basemap | |||
| * `streets` - Default [Esri street basemap](http://www.arcgis.com/home/webmap/viewer.html?webmap=7990d7ea55204450b8110d57e20c99ab) | |||
| * `satellite` - Esri's [satellite basemap](http://www.arcgis.com/home/webmap/viewer.html?webmap=d802f08316e84c6592ef681c50178f17¢er=-71.055499,42.364247&level=15) | |||
| * `hybrid` - Satellite basemap with labels | |||
| * `topo` - Esri [topographic map](http://www.arcgis.com/home/webmap/viewer.html?webmap=a72b0766aea04b48bf7a0e8c27ccc007) | |||
| * `gray` - Esri gray canvas with labels | |||
| * `gray-background` - Esri [gray canvas](http://www.arcgis.com/home/webmap/viewer.html?webmap=8b3d38c0819547faa83f7b7aca80bd76) without labels | |||
| * `oceans` - Esri [ocean basemap](http://www.arcgis.com/home/webmap/viewer.html?webmap=5ae9e138a17842688b0b79283a4353f6¢er=-122.255816,36.573652&level=8) | |||
| * `national-geographic` - [National Geographic basemap](http://www.arcgis.com/home/webmap/viewer.html?webmap=d94dcdbe78e141c2b2d3a91d5ca8b9c9) | |||
| * `osm` - [Open Street Map](http://www.openstreetmap.org/) | |||
| * `stamen-toner` - [Stamen Toner](http://maps.stamen.com/toner/) black and white map with labels | |||
| * `stamen-toner-background` - [Stamen Toner](http://maps.stamen.com/toner-background/) map without labels | |||
| * `stamen-toner-lite` - [Stamen Toner Light](http://maps.stamen.com/toner-lite/) with labels | |||
| * `stamen-terrain` - [Stamen Terrain](http://maps.stamen.com/terrain/) with labels | |||
| * `stamen-terrain-background` - [Stamen Terrain](http://maps.stamen.com/terrain-background/) without labels | |||
| * `stamen-watercolor` - [Stamen Watercolor](http://maps.stamen.com/watercolor/) | |||
| * `tileurl` - To use other map tiles, you can provide the tile URL pattern. Make sure to include the literal strings `{x}` `{y}` `{z}` in the URL which will be replaced with the appropriate tile number when generating the map | |||
| * `attribution` - default `none` - `none | esri | mapbox` - If you add attribution on the image in some other way, you can set this to "none", otherwise you can include the default esri or mapbox attributions | |||
| * `latitude` - optional - Latitude to center the map at. Not needed if using the location parameter, or if specifying one or more markers. | |||
| * `longitude` - optional - Longitude to center the map at. | |||
| * `location` - optional - Free-form text that will be geocoded to center the map. Not needed if specifying a location with the latitude and longitude parameters, or if a marker is specified. | |||
| * `marker[]` - Specify one or more markers to overlay on the map. Parameters are specified as: `key:value;`. See below for the full list of parameters. | |||
| * `path[]` - Specify one or more paths to draw on the map. See below for the full list of parameters to draw a path. | |||
| ## Markers | |||
| * `location` - Free-form text that will be geocoded to place the pin | |||
| * `lat` - If a `location` is not provided, you can specify the location with the `lat` and `lng` parameters. | |||
| * `lng` - See above | |||
| * `icon` - Icon to use for the marker. Must choose one of the icons provided in this library, or specify a full URL to a png image. If an invalid icon is specified, the marker will not be rendered. | |||
| ### Built-In Marker Images | |||
| *  `dot-large-blue` | |||
| *  `dot-large-gray` | |||
| *  `dot-large-green` | |||
| *  `dot-large-orange` | |||
| *  `dot-large-pink` | |||
| *  `dot-large-purple` | |||
| *  `dot-large-red` | |||
| *  `dot-large-yellow` | |||
| *  `dot-small-blue` | |||
| *  `dot-small-gray` | |||
| *  `dot-small-green` | |||
| *  `dot-small-orange` | |||
| *  `dot-small-pink` | |||
| *  `dot-small-purple` | |||
| *  `dot-small-red` | |||
| *  `dot-small-yellow` | |||
| *  `fb` | |||
| *  `google` | |||
| *  `large-blue-blank` | |||
| *  `large-blue-cutout` | |||
| *  `large-gray-blank` | |||
| *  `large-gray-cutout` | |||
| *  `large-gray-user` | |||
| *  `large-green-blank` | |||
| *  `large-green-cutout` | |||
| *  `large-orange-blank` | |||
| *  `large-orange-cutout` | |||
| *  `large-pink-blank` | |||
| *  `large-pink-cutout` | |||
| *  `large-purple-blank` | |||
| *  `large-purple-cutout` | |||
| *  `large-red-blank` | |||
| *  `large-red-cutout` | |||
| *  `large-yellow-blank` | |||
| *  `large-yellow-cutout` | |||
| *  `large-yellow-message` | |||
| *  `large-yellow-user` | |||
| *  `small-blue-blank` | |||
| *  `small-blue-cutout` | |||
| *  `small-gray-blank` | |||
| *  `small-gray-cutout` | |||
| *  `small-gray-message` | |||
| *  `small-gray-user` | |||
| *  `small-green-blank` | |||
| *  `small-green-cutout` | |||
| *  `small-green-user` | |||
| *  `small-orange-blank` | |||
| *  `small-orange-cutout` | |||
| *  `small-pink-blank` | |||
| *  `small-pink-cutout` | |||
| *  `small-pink-user` | |||
| *  `small-purple-blank` | |||
| *  `small-purple-cutout` | |||
| *  `small-red-blank` | |||
| *  `small-red-cutout` | |||
| *  `small-yellow-blank` | |||
| *  `small-yellow-cutout` | |||
| *  `small-yellow-user` | |||
| ## Paths | |||
| A path is specified as a list of longitude and latitudes, as well as optional properties to specify the weight and color of the path. | |||
| The coordinates of the path are the first value of the property, specified as a list of coordinates similar to GeoJSON. | |||
| ### Examples | |||
| Simple path with default color and weight. | |||
| ``` | |||
| path[]=[-122.651082,45.508543],[-122.653617,45.506468],[-122.654183,45.506756] | |||
| ``` | |||
| Specifying the color and weight of the path. | |||
| ``` | |||
| path[]=[-122.651082,45.508543],[-122.653617,45.506468],[-122.654183,45.506756];weight:6;color:0033ff | |||
| ``` | |||
| ## Examples | |||
| ### Simple map centered at a location | |||
| ``` | |||
| https://atlas.p3k.io/map/img?basemap=gray&width=400&height=240&zoom=14&latitude=45.5165&longitude=-122.6764 | |||
| ``` | |||
| <img src="/map/img?basemap=gray&width=400&height=240&zoom=14&latitude=45.5165&longitude=-122.6764"> | |||
| ### Map with a marker centered at an address | |||
| ``` | |||
| https://atlas.p3k.io/map/img?marker[]=location:920%20SW%203rd%20Ave,%20Portland,%20OR;icon:small-blue-cutout&basemap=gray&width=400&height=240&zoom=14 | |||
| ``` | |||
| <img src="/map/img?marker[]=location:920%20SW%203rd%20Ave,%20Portland,%20OR;icon:small-blue-cutout&basemap=gray&width=400&height=240&zoom=14"> | |||
+ 5
- 0
public/assets/styles.css
View File
+ 6
- 1
views/index.php
View File
+ 0
- 5
views/layout.php
View File
+ 16
- 0
views/static-maps.php
View File
| @ -0,0 +1,16 @@ | |||
| <header> | |||
| <h1>Atlas Static Maps</h1> | |||
| <p>Atlas Static Maps is an API for generating map images with markers or other overlays</p> | |||
| </header> | |||
| <div class="page docs"> | |||
| <?php | |||
| $markdown = file_get_contents(__DIR__.'/../data/static-maps.md'); | |||
| $html = Michelf\Markdown::defaultTransform($markdown); | |||
| echo $html; | |||
| ?> | |||
| </div> | |||