{"id":13583503,"url":"https://github.com/roblabs/apple-maps-web-snapshot-cli","last_synced_at":"2025-04-12T20:03:59.429Z","repository":{"id":42581916,"uuid":"219377319","full_name":"roblabs/apple-maps-web-snapshot-cli","owner":"roblabs","description":"Create static maps 🗺 for Apple Maps using the Maps Web Snapshots announced at WWDC 2019.","archived":false,"fork":false,"pushed_at":"2023-07-12T13:22:39.000Z","size":3455,"stargazers_count":11,"open_issues_count":2,"forks_count":4,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-12T20:03:09.684Z","etag":null,"topics":["apple-maps","mapkit","mapkit-js","node","static-maps"],"latest_commit_sha":null,"homepage":"https://RobLabs.com/apple-maps-web-snapshot-cli","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/roblabs.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-11-03T22:59:37.000Z","updated_at":"2024-07-20T19:37:03.000Z","dependencies_parsed_at":"2024-11-06T00:31:43.111Z","dependency_job_id":"dd941dc2-a557-45fd-b362-8e331ea9ae3e","html_url":"https://github.com/roblabs/apple-maps-web-snapshot-cli","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roblabs%2Fapple-maps-web-snapshot-cli","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roblabs%2Fapple-maps-web-snapshot-cli/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roblabs%2Fapple-maps-web-snapshot-cli/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/roblabs%2Fapple-maps-web-snapshot-cli/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/roblabs","download_url":"https://codeload.github.com/roblabs/apple-maps-web-snapshot-cli/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248625493,"owners_count":21135513,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apple-maps","mapkit","mapkit-js","node","static-maps"],"created_at":"2024-08-01T15:03:31.567Z","updated_at":"2025-04-12T20:03:59.403Z","avatar_url":"https://github.com/roblabs.png","language":"JavaScript","funding_links":[],"categories":["JavaScript"],"sub_categories":[],"readme":"# Maps Web Snapshot\n\nAt WWDC 2019, Apple announced Maps Web Snapshots for creating a static map from a URL.  \n\n* Documentation at [developer.apple.com/documentation/snapshots](https://developer.apple.com/documentation/snapshots)\n* Maps Snapshot Studio from Apple — [maps.developer.apple.com/snapshot](https://maps.developer.apple.com/snapshot)\n* Web service endpoint and notes on the query parameters  — [developer.apple.com/documentation/snapshots/create_a_maps_web_snapshot](https://developer.apple.com/documentation/snapshots/create_a_maps_web_snapshot)\n* Developer Forum with the tag: [Maps Web Snapshots](https://developer.apple.com/forums/tags/maps-web-snapshots)\n  * Forum thread on [Image annotations larger than 50px](https://developer.apple.com/forums/thread/655042)\n* Announcement from the Apple Developer Forums (around WWDC 2020):\n  * [*Now Available: Image Annotations on Maps Web Snapshots*](https://developer.apple.com/forums/thread/649750)\n\n\n## Usage\n\nUpdate your credentials in `config.json` then install and run.\n\n```bash\n# config.json\n#   Do not commit your secrets\n{\n  \"teamId\":             \"XXXXXXXXXX\",\n  \"keyId\":              \"YYYYYYYYYY\"\n  \"privateKey\": \"AuthKey_YYYYYYYYYY.p8\",\n}\n```\n\n``` bash\n# install\nnpm install\n\n# run and inspect output\nmapkit-snapshots.js null-island.geojson -c config.json\n```\n\n### Online help\n\nOnline help is available by supplying no parameters.\n\n```bash\nmapkit-snapshots.js\n```\n\n```bash\nUsage:\n  mapkit-snapshots.js \u003cfile.geojson\u003e -c config.json     # -c pass in privateKey, teamId, keyId\n  mapkit-snapshots.js \u003cfile.geojson\u003e -c config.json -o  # -o opens in default browser\n```\n\nGenerate a URL to display a map from a Apple Maps Web Snapshot.  \n\nFind the source code at [roblabs/apple-maps-web-snapshot-cli](https://github.com/roblabs/apple-maps-web-snapshot-cli)\n\nSee the sample GeoJSON, `null-island.geojson` for example valid properties\n\n``` Javascript\n\"properties\": {\n  \"center\": [20, 20],\n  \"display_point\": {\n    \"type\": \"Point\",\"coordinates\": [10,10]\n  },\n  \"z\": 2,\n  \"spn\": [1.0, 1.0],\n  \"size\": [600, 400],\n  \"scale\": 1,\n  \"t\": \"mutedStandard\",\n  \"colorScheme\": \"dark\",\n  \"poi\": 1,\n  \"lang\": \"en-US\",\n  \"annotations\": [],\n  \"overlays\": [],\n  \"referer\": \"\",\n  \"expires\": 3155673601\n}\n```\n\n## Apple MapKit JS Examples\n\nThis repo shows working samples of Maps Web Snapshots and Node JS sample code for generating the proper URLs to use in your applications.\n\n| Snapshot Parameters or Documenation from [Create a Maps Web Snapshot](https://developer.apple.com/documentation/snapshots/create_a_maps_web_snapshot#center) |  Parameter examples|\n| :------------- | :------------- |\n| **`center`** - The center of the map. You can specify center as coordinates or as an address.  |   |\n|   |  [signIt(\\\"center=0,0\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=0,0\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=_CQvIG7iQGN-0tiyqXAOBbjt0tInsepLNbCeO8sbhkdS7VLf2hDCdiQluSRTfmVcWLzABiqeK96YqgH2qYYOgA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=vBLwprXb_BKv417xNjPFYtsVlwAO1jM_ywxa7AR5MoinYyMaWa3doXu9KD0kiDeUdx8bvFGavXggeFwKSlGKxA) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=t76FXl_bIIv9s9LabHtorewlx9UMDvsrCAo0UeSCKKUyKFjg3IhDu6n3ApaDrwwKj-86ANk1GjpDHSuE8Oh5jA) |\n| **`size \u0026 scale`** - `size` - The width and height must be within the range of [50, 640]. Default: 600x400. `scale` - The pixel density of the image. scale=2 returns an image intended for 2× Retina displays. |  |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026scale=1\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026scale=1\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=YA-Wzqp3VDrrT1nqkbY_l63-NqGXKtNIG8mJFqIq_2-lcaGW6qvfIX7Bk1xAsOdTSgu7i1o9KV6tSj-DFx4Hyg) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026scale=2\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026scale=2\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=Cb9io7vYYAKK-VRkw7LHGfMUsfUSEIMMZHcl8TryR7JiAYimt6eZliS7vVR0xygB5EWhysfKnIEBImbNUF1imA) |\n| **`t`** - The map type.  Possible values: standard, hybrid, satellite, mutedStandard | ![](assets/t.gif)\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026t=standard\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026t=standard\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=mz4a82aYZSa9tif0xNk6Y1FPc6qgd0wLoeFpHoz7AG3cdrwjQNRiqDaPCEgeWUAl2R_NeMGOc9pHPNqLxfrNeA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026t=hybrid\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026t=hybrid\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=PUr_jizu7C0UcZ_ZQgUiZJ7ou-ZKEIOIFCvrt-Rn6BKxeyNdILowtXSpOtn6P90B8bw_XEO5iJoiewJYzdaqwA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026t=satellite\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026t=satellite\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=oIjW35TikDHnTbmDQ_3IhBqiurI6hqWKxAkNlvvXMi8O6_FhrxM_-tOUEpa3-9mqVo5dbgCbBi4dRvu7ZrKNeg) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026t=mutedStandard\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026t=mutedStandard\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=5S5WmubPUfHWeSC8zgAQBYR3jAAx6p9DRYnagOMzx9xJZxB-JoMMhvGaE2yDppb2SU0UY2iGeJuA7efuSfg6AA) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=standard\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=standard\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=lPSdzn6czRvKWg1AxJQ30n2B5fUha4sh0VP2zcLuC9Imt6Mrc-AD6DA7Nrc8XoptHiZ4VDH3FF5LM4qrayiBzQ) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=hybrid\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=hybrid\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=H4A4thBAWFrvgX8GuovdPlmjy_3DSnItX4MsSYBdvmo96OymSbK2gAuEjEzwNv0l0Xj6CI1UbMxqfCtUc41OxQ) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=satellite\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=satellite\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=7FGJ1JjkSohegbrN5Rrh84A3kBSusbaXWZvmLITKOH3dqKZNIKmTJVONOR5gy7yMuDgiDVS-fxXF-LwTDICkEw) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=mutedStandard\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=mutedStandard\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=ydxvw2A_-12_6GyMr8tveiDwD69UF0fY3bHYnGppF413kYNir0RUFxsJ6_WPz47YXe1VkOvtXcAHTthF5Kwccg) |\n| **`colorScheme`** - The color scheme of the map.  Possible values: light, dark. The dark color scheme only applies to the `standard` and `mutedStandard` map types. | ![](assets/colorScheme.gif)\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=standard\u0026colorScheme=light\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=standard\u0026colorScheme=light\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=VcNbRE3kHLrshJaSe6yTKjECAyUFRe9YZpHvmbUAKkvhUAtzGOXXaoxk0prTvaC-1F-RmaHbl4n3UNqg_Z12LA) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=standard\u0026colorScheme=dark\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=standard\u0026colorScheme=dark\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=crD96c6VOA8XyvuYAi9l1j8rvcbPBQrU7WmPbIvuK4GZqUqnalgvx3oaQ_elVe6oot60JDBDTTIocB5yCSrv3A) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=mutedStandard\u0026colorScheme=light\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=mutedStandard\u0026colorScheme=light\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=JYPWEYfCTL_AAsaQuuNjbzgnviTJTRH7dUXede05l2ON2Taijnt_c_8YXlYhLOVbKtTZooWNlyuLQ1iNAzIy4g) |\n|   |  [signIt(\\\"center=San%20Diego,%20California\u0026t=mutedStandard\u0026colorScheme=dark\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026t=mutedStandard\u0026colorScheme=dark\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=opuNjPhzMb06ESlXf94STjHcZnB1za9CwaG1BsUQgdx1JhyeU3T4mpatqAD1Qi8d5KT3ncGc_onEVZnjflK1Yw) |\n| **`z`** - The zoom level of the map.  | ![](assets/z.gif)\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=15\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=15\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=pUUoZ7mIon70G4Xa3TrpcK_5un_waTXOxezS8u9qywHHcxmhjAZpRyUjZ-SsaJ05-GSWVZX9UgNOvMf1Ba9T2A) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=14\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=14\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=XrL4G6wNunFeLYfuV_dQ89pcyqihOtYw5dWn4ESiUEvHoTiptaWzdV7Abi0gR-EK3Vn43gWaBJoii3UNQ5gccA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=13\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=13\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=YmwpwvEkwDyeotXx__ogs1JOoULIbMIQjoqYX8Ix9lvDhW5f8fNU4hIr13ZbQ0dUar4fw7Mx5peVw75YwKDyAA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=12\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=12\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=Vkj5glB1WeGztGobS_5EIvIxEQi2DHQXytVDHvA3IEfqoqIlLIicl-9O84vrswsKAqQVmnRUDOGw6n-H9CjKyg) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=11\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=11\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=d9C5kBKjmR5xEy14OQXobUtZbMpsCcf_voWk5M_JDsegKVU6Idg5O4iDqz_AX_zRwxM-cBekS3FfRhYL-Nz6oQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=10\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=10\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=CZ90uXzEFPTEf8N2jtJoJY80okgf4dzQFIskMS1xRvQabdl3zx-Ut0aQdrz_RBgyu0BlpQJEoJL0T8nP_NG7ug) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=9\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=9\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=7OAiv1VSLhwkYEjsfLwEKh_uDFLJGrpdqUJnDBzRQL6qCerfLwlUk9R2BsCF6Kl9kdcxKyGu7Vf3FazULXqdgQ) |\n| **`poi`** - A Boolean value indicating whether points of interest are shown on the map.  | ![](assets/poi.gif) |\n|   |  [signIt(\\\"center=San%20Francisco,%20California\u0026t=mutedStandard\u0026poi=0\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Francisco,%20California\u0026t=mutedStandard\u0026poi=0\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=2Xu7FoCPZgcg2HnHwBVpaCvUnxIFp0aR3mzxCDjtrlPv3D4nM48gS4AaDoq4hWEoVIOdLv7CKA7TdvoTRJGclA) |\n|   |  [signIt(\\\"center=San%20Francisco,%20California\u0026t=mutedStandard\u0026poi=1\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Francisco,%20California\u0026t=mutedStandard\u0026poi=1\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=yZyRYiWZQNYLQ9SKXIpNjArUYoVYKGvQhD8unThM8_TbagdAyE_Ik3p2CYbApYFCNw4Cw6eRqZkmAp9LQlQAzA) |\n| **`lang`** - The language to be used for labels on the map, Supported values are in [locale IDs](https://developer.apple.com/library/archive/documentation/MacOSX/Conceptual/BPInternational/LanguageandLocaleIDs/LanguageandLocaleIDs.html), such as en-GB or es-MX. | ![](assets/lang.gif)\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=ar-AR\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=ar-AR\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=EfCgPO0IF1sAuhV7tTSkDHGnkLFdlxPPntOgqi1PFgnibbRZc-MvPumLTPfJNKJA99hcPHZ2Ri_zDAYyzEw5oA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=de-DE\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=de-DE\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=v0fcIINKQiGtBSU_Hps_gIAxE3uBmZbi29HfVfbJN7GPuDEeTsjvW-SvkUQmneTijYSL3qTm_i8AtpI0oT54vg) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=en-US\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=en-US\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=VlYwE5qXxEFzeKULfxGxgwgzjK9PJz9O8LsXjbizU_sb1fmQrbRYoOknyVzSV2gbq9LvSRYXnbfc_sKuLv54HA) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=es-MX\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=es-MX\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=1-970l0FuwTPZgXoTsGfGkhrjjUzY-mxLgGOeGwqIbjYz65FEoIf4p1Tu43aVxTb6gvGVx5QnAnAPK-QWEVwDg) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=es-ES\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=es-ES\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=LRlNKCRxFB_n-xg8UwZIRc0F8t8n8Ck0Pec3Pz9FmT29HBiX9CbcdVM-Wb0DJBjO2Ta6V8BHrkjkDJPkhWT4nQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=el-GR\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=el-GR\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=WUSOf-HW7jPvbv-BV10gpSYxlQ8hOkiV-PKEz_ECXDDzC8UDpBfm6GrFjCr4mUrrizlgws8-Ndh0rOZDUYnQWw) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=fi-FI\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=fi-FI\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=pIA_QZJZGpbIgkaMtcjLUnOrgCI53qFh5oXrn8IAtVuJ6mjOa1P7Yc0bu50BaHDkIvvGqDiQr1bB1dGjDKIrnQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=fr-FR\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=fr-FR\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=jA0v_xwMe8NUOTj9dsrQc9Z6USGhekatKsqxoaPVP-X2Go_QIKJnCgcUESWR5Sd9cEywW7uC8GM6nZaMmZiMWQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=ja-JA\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=ja-JA\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=yB0WRehXzOyQMfaCpZ8J2nGmSc484NDE9IO1OU4etcsbHmPHtoPh7Be_OdqdvJdhmflvwktX_jFZXTe2wJMbVw) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=hu-HU\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=hu-HU\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=Rck8se1DVokC0COyUj3unZQ5BybSensLM2Ku9rsuBfwzZKfN1CaR5szSA6qKH1Jrjpm0mDqQAjz_17Nf9-w5Vg) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=it-IT\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=it-IT\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=Y71gWPLRd5ONKYg2qRRxQAa3y4kSvPWN_0gL59R1E_XCKS7KglGJPobtMwj2lS9Pd0SFxwIv-HbfpvDuBuJqEg) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=ko-KO\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=ko-KO\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=k-h1YNcqH-DzrvwIEOpRV_-W3UattFI0xKlVJzToh8QL0dN80wh8ZZ3cHdhMb1Mk6nmS17xVVCQzayXmmvJh8Q) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=nl-NL\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=nl-NL\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=wKO6OxuTaDvujS7jEdBCwNwZ04Q_U5G5s3iZu3-XnY9hiWRgJKGkaQQJLffRr5dHBAat0-SpL4A6uk4Ab_6BTQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=no-NO\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=no-NO\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=ZisQEbZZOZhcvFWli8sl7iODwOoMyqcauHerUxd-GQibns_DEMJjuWeczEbBVtjGxFuL9pxUDzOPnAtRSHU3Mw) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=he-HE\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=he-HE\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=SOH5qn-tVgIF6l_jJQYcCpIqeCTZ6yDuaf60ja0FdmGtktPxWkksHDVfo2jYJo470Xqvj3ytft_UzIFIFGSF_A) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=hi-IN\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=hi-IN\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=J9uPvzKUAzZt66b4BKq6fxa_liDQcLyzzerS9ErbD0Vag_F25SW230py99QXerzL1am32FgdxtlQv7CCv5lLcQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=pt-BR\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=pt-BR\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=jaJ0Tk5ShePZGccsoG8_Sn6QoTDdLmqu8AQtDVLw10OQIEAVSrw6F_iXWRrTD1it87lH8lOvmxmpcshON4g82Q) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=ru-RU\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=ru-RU\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=h363-j7Sux1LQx3FVQIdw22HXDAaAPSX4kIYsRN7V3UDFS3XmFt2inENkCk-eGO4Hvdyo_m9k_Dx73oGvxMz1A) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=tr-TR\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=tr-TR\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=jnJpJgHZiOWWV2YXguwdkr65NVbZhKnoX-8mmMZ9uk5wtLgOvzwyySEwv8sNZc9gIjSi1ljS7TEBNvySyBoBrw) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=vi-VI\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=vi-VI\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=NEv093MrQJBfcdEQCU8nMVfsqjvI6rnb4b2LEbBebyEAJYN5XOZSCXk1x9bTj5WaCc6_y0AUFyAkdmvMs1gbXQ) |\n|   |  [signIt(\\\"center=37.839622,-119.515182\u0026z=3\u0026lang=zh-ZH\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=37.839622,-119.515182\u0026z=3\u0026lang=zh-ZH\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=L6tZdfL4x-0oOQUJyABERtmIrY6Xoh-_VnNnLuyZRDLdkiYrXl8a8sL8gzJalAnDF1o9ZBQYVylrZyCdT3WcIA) |\n| **`annotations`** - Example of [Annotations](https://developer.apple.com/documentation/snapshots/annotation) .  The array of JSON Annotation, which draws 3 points: a red `dot`, a green `balloon`, \u0026 blue `large` annotations, is shown `[{\"point\":\"32.73,-117.19\", \"color\":\"blue\",  \"glyphText\":\"A\", \"markerStyle\":\"large\"},` \u003cbr\u003e `{\"point\":\"32.71,-117.17\", \"color\":\"00ff00\",\"glyphText\":\"9\", \"markerStyle\":\"balloon\"},` \u003cbr\u003e `{\"point\":\"32.69,-117.16\", \"color\":\"red\",   \"glyphText\":\"a\", \"markerStyle\":\"dot\"}` \u003cbr\u003e `]` | ![](assets/annotations/snapshot.png) |\n| Live example of Annotations |  [signIt(\\\"center=San%20Diego,%20California\u0026\\\u003curlEncoded Annotations\\\u003e\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026annotations=%5B%7B%22point%22%3A%2232.732373%2C-117.197503%22%2C%22color%22%3A%22blue%22%2C%22glyphText%22%3A%22A%22%2C%22markerStyle%22%3A%22large%22%7D%2C%7B%22point%22%3A%2232.715104%2C-117.174038%22%2C%22color%22%3A%2200ff00%22%2C%22glyphText%22%3A%229%22%2C%22markerStyle%22%3A%22balloon%22%7D%2C%7B%22point%22%3A%2232.699945%2C-117.169792%22%2C%22color%22%3A%22red%22%2C%22glyphText%22%3A%22a%22%2C%22markerStyle%22%3A%22dot%22%7D%5D\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=ZGhh0aC2Gx-2TPpt3ZAHzO2t-3MA5hcax6x3ZLzPdFNg0clr6rTGofG6TDNWe5TDZQH4sZyC8HP73df5GPn9SQ) |\n| **`overlays`** - Example of [Overlays](https://developer.apple.com/documentation/snapshots/overlay).    The array of JSON `Overlay` objects, which draws a red dashed line over 3 points, is shown:\u003cbr\u003e `[{\"points\":[\"32.73,-117.19\",\"32.71,-117.17\",\"32.69,-117.16\"],`\u003cbr\u003e`\"strokeColor\":\"ff0000\",\"lineWidth\":2,\"lineDash\":[10,5]}`\u003cbr\u003e`]`  | ![](assets/overlays/snapshot.png) |\n|  Live example of Overlays |  [signIt(\\\"center=San%20Diego,%20California\u0026\\\u003curlEncoded Overlay\\\u003e\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026overlays=%5B%7B%22points%22%3A%5B%2232.732373%2C-117.197503%22%2C%2232.715104%2C-117.174038%22%2C%2232.699945%2C-117.169792%22%5D%2C%22strokeColor%22%3A%22ff0000%22%2C%22lineWidth%22%3A2%2C%22lineDash%22%3A%5B10%2C5%5D%7D%5D\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=WYbdsjcE22KI8tCrxM0YJJdYFfNgsC58OlhpTatdszcC2o53A-EDW5J4XbsCxhdEv4jFy_DW3Rq19jCBAc7q6w) |\n| Live example of Annotations \u0026 Overlays, together|  [signIt(\\\"center=San%20Diego,%20California\u0026\\\u003curlEncoded Annotation \u0026  Overlay\\\u003e\\\")](https://snapshot.apple-mapkit.com/api/v1/snapshot?center=San%20Diego,%20California\u0026annotations=%5B%7B%22point%22%3A%2232.732373%2C-117.197503%22%2C%22color%22%3A%22blue%22%2C%22glyphText%22%3A%22A%22%2C%22markerStyle%22%3A%22large%22%7D%2C%7B%22point%22%3A%2232.715104%2C-117.174038%22%2C%22color%22%3A%2200ff00%22%2C%22glyphText%22%3A%229%22%2C%22markerStyle%22%3A%22balloon%22%7D%2C%7B%22point%22%3A%2232.699945%2C-117.169792%22%2C%22color%22%3A%22red%22%2C%22glyphText%22%3A%22a%22%2C%22markerStyle%22%3A%22dot%22%7D%5D\u0026overlays=%5B%7B%22points%22%3A%5B%2232.732373%2C-117.197503%22%2C%2232.715104%2C-117.174038%22%2C%2232.699945%2C-117.169792%22%5D%2C%22strokeColor%22%3A%22ff0000%22%2C%22lineWidth%22%3A2%2C%22lineDash%22%3A%5B10%2C5%5D%7D%5D\u0026teamId=J7V35W7ES8\u0026keyId=VKGGG3L5BX\u0026signature=m9UAKoC0ShqSpMTHAvIlH2R3qFllvtDtJkchCHRYu6MB69MjsX09FNELsuD3jCegnkr1QV0JIsv5r9nhLlNzrw) |\n\n\n### Release Log\n\n* Dec 30, 2021 - Add output key `url` to log the signed Apple Maps Web Snapshot URL\n* Nov 04, 2021 - Add command line options:  `-c` for credentials.  `-o` to open in browser.\n* Mar 09, 2020 - Pass in values from GeoJSON.  Pass in credentials via `config.json`.\n* Nov 04, 2019 - Update Javascript example for Annotations \u0026 Overlays.\n* Nov 03, 2019 - Initial Sample Code for Maps Web Snapshots with MapKit JS\n\n\n\u003c!--\n// Generate `git log` format with\ngit log --pretty=format:\"* %ad - %s\" --date=format:'%b %d, %Y'\n--\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froblabs%2Fapple-maps-web-snapshot-cli","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Froblabs%2Fapple-maps-web-snapshot-cli","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Froblabs%2Fapple-maps-web-snapshot-cli/lists"}