Failed to extract signature
8 changed files with 241 additions and 13 deletions
Unified 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> | |||||