Skip to content
This repository was archived by the owner on Aug 26, 2025. It is now read-only.

Commit bf820ef

Browse files
miaxzhitongstevemunkjhendrixMSFT
authored
Azure Map Rendering 20240401 (Azure#27950)
* Adds base for updating Render from version stable/2022-08-01 to version 2024-04-01 * Updates readme * Updates API version in new specs and examples * update static map API doc * small change on static map doc * update tilesetId section * add static map supported tilesetid and trafficLayer * update range table and static image example * fix typo * add additional static image example * error fix * run prettier on static image example json * set tilesetId as optional * update max/min latitude/longitude table * update Accept header for static image API * error fix * add explanation for Accept header * typo * add parameter limitation * improve wording * add path and pin parameter type * fix tables * improve on example * typo fix * run prettier * wording fix * map attribution description update Co-authored-by: steve munk <[email protected]> * state tile description update Co-authored-by: steve munk <[email protected]> * map tile description update Co-authored-by: steve munk <[email protected]> * map tileset description update Co-authored-by: steve munk <[email protected]> * map copyright caption description change Co-authored-by: steve munk <[email protected]> * map copyright bounding description update Co-authored-by: steve munk <[email protected]> * weather radar tile description update Co-authored-by: steve munk <[email protected]> * weather infrared tiles description update Co-authored-by: steve munk <[email protected]> * map copyright tile description update Co-authored-by: steve munk <[email protected]> * map copyright world description update Co-authored-by: steve munk <[email protected]> * remove pricing tiers applies * Adds base for updating Render from version stable/2022-08-01 to version 2024-04-01 * Updates readme * Updates API version in new specs and examples * update static map API doc * small change on static map doc * update tilesetId section * add static map supported tilesetid and trafficLayer * update range table and static image example * fix typo * add additional static image example * error fix * run prettier on static image example json * set tilesetId as optional * update max/min latitude/longitude table * update Accept header for static image API * error fix * add explanation for Accept header * typo * add parameter limitation * improve wording * add path and pin parameter type * fix tables * improve on example * typo fix * run prettier * wording fix * map attribution description update Co-authored-by: steve munk <[email protected]> * state tile description update Co-authored-by: steve munk <[email protected]> * map tile description update Co-authored-by: steve munk <[email protected]> * map tileset description update Co-authored-by: steve munk <[email protected]> * map copyright caption description change Co-authored-by: steve munk <[email protected]> * map copyright bounding description update Co-authored-by: steve munk <[email protected]> * weather radar tile description update Co-authored-by: steve munk <[email protected]> * weather infrared tiles description update Co-authored-by: steve munk <[email protected]> * map copyright tile description update Co-authored-by: steve munk <[email protected]> * map copyright world description update Co-authored-by: steve munk <[email protected]> * remove pricing tiers applies * reduce get copyright example length * add summary for render 20240401 * remove summary from static image * remove please from language and view * add package-2024-04-01 to readme * revert back common change * revert changes in maps readme * \n fix Co-authored-by: steve munk <[email protected]> * typo fix Co-authored-by: steve munk <[email protected]> * typo fix for map copyright caption Co-authored-by: steve munk <[email protected]> * typo fix for statetile Co-authored-by: steve munk <[email protected]> * typo fix for map copyright world Co-authored-by: steve munk <[email protected]> --------- Co-authored-by: steve munk <[email protected]> Co-authored-by: Joel Hendrix <[email protected]>
1 parent f98d676 commit bf820ef

11 files changed

+1342
-3
lines changed

‎specification/maps/data-plane/Render/readme.md‎

Lines changed: 12 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -27,11 +27,10 @@ These are the global settings for Render Client.
2727
``` yaml
2828
title: RenderClient
2929
openapi-type: data-plane
30-
tag: 2.1 # removed "preview" as it started causing validation errors from v0.26 of the Swagger Lintdiff.
31-
# at some point those credentials will move away to Swagger according to [this](https://github.com/Azure/autorest/issues/3718)
30+
tag: package-2024-04-01
3231
add-credentials: true
3332
credential-default-policy-type: BearerTokenCredentialPolicy
34-
credential-scopes: https://atlas.microsoft.com/.default
33+
credential-scopes: 'https://atlas.microsoft.com/.default'
3534
track2: true
3635
verbose: true
3736
sdk-integration: true
@@ -48,9 +47,19 @@ directive:
4847
reason: false positive from oav is breaking our example validation. See azure/oav#1021.
4948
```
5049
50+
51+
### Tag: package-2024-04-01
52+
53+
These settings apply only when `--tag=package-2024-04-01` is specified on the command line.
54+
55+
```yaml $(tag) == 'package-2024-04-01'
56+
input-file:
57+
- stable/2024-04-01/render.json
58+
```
5159
### Tag: 2022-08-01
5260

5361
These settings apply only when `--tag=2022-08-01` is specified on the command line.
62+
5463
``` yaml $(tag) == '2022-08-01'
5564
input-file:
5665
- stable/2022-08-01/render.json

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetCopyrightCaption.json‎

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,14 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"format": "json"
5+
},
6+
"responses": {
7+
"200": {
8+
"body": {
9+
"formatVersion": "0.0.1",
10+
"copyrightsCaption": "© 1992 - 2022 TomTom."
11+
}
12+
}
13+
}
14+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetCopyrightForTile.json‎

Lines changed: 86 additions & 0 deletions
Large diffs are not rendered by default.

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetCopyrightForWorld.json‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"format": "json"
5+
},
6+
"responses": {
7+
"200": {
8+
"body": {
9+
"formatVersion": "0.0.1",
10+
"generalCopyrights": [
11+
"© 1992 - 2022 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection, database right protection and other intellectual property rights owned by TomTom or its suppliers. The use of this material is subject to the terms of a license agreement. Any unauthorized copying or disclosure of this material will lead to criminal and civil liabilities.",
12+
"Data Source © 2022 TomTom",
13+
"based on"
14+
],
15+
"regions": [
16+
{
17+
"country": {
18+
"ISO3": "ABW",
19+
"label": "Aruba"
20+
},
21+
"copyrights": [
22+
"You agree to include as soon as practically possible, but no later than the first new release of the Authorized Application following Your receipt of any 3D Landmarks, any copyright notices related to the display of such landmarks on every Authorized Application and in the “about box” of the Authorized Application. Notwithstanding the aforementioned, TomTom has the right to decide, at its sole discretion, to remove specific 3D Landmarks in subsequent releases of the Licensed Products. In such case, You will remove those 3D Landmarks from the Authorized Application as soon as practically possible, but not later than the first new release of the Authorized Application following Your receipt of the Update to the Licensed Product. TomTom shall not be held responsible for any possible damages, costs or expenses incurred by You related to such removal of a 3D Landmark by TomTom from the Licensed Product or failure to remove a 3D Landmark by You from the Authorized Application.",
23+
"TomTom hereby grants to You a non-exclusive, non-transferable license to use the Software Licensed Products for the sole and limited purpose of assisting You in viewing, analyzing and sectioning the Licensed Products. In no event shall You use the Software Licensed Products to view, analyze, section or in any way manipulate spatial map data that is not provided by TomTom. You shall not derive or attempt to derive the source code of all or any portion of the Licensed Products by reverse engineering, disassembly, decompilation, translation or any other means. You shall affix the following copyright notice on any copy of the GDF Viewer, or any portion of the Licensed Products: “Software ©2011-2020 TomTom North America, Inc. All rights reserved.",
24+
"Neither the Data nor the Licensed Products such as Speed Profiles or TomTom Traffic or any derivatives thereof shall be used for the purpose of enforcement of traffic laws including but not limited to the selection of potential locations for the installation of speed cameras, speed traps or other speed tracking devices. With regards to Speed Profiles, You acknowledge and agrees that the actual speeds may not reflect the legally imposed speed limits.",
25+
"You specifically agree that it shall not: (i) store the data for more than twenty-four (24) hours on Your servers; (ii) broadcast or make Live Services Licensed Products available except to authorized End Users; and (iii) use the feed or information received via the feed for historical data purposes (including but not limited to collection or analysis)."
26+
]
27+
},
28+
"......",
29+
{
30+
"country": {
31+
"ISO3": "ZWE",
32+
"label": "Zimbabwe"
33+
},
34+
"copyrights": [
35+
"You agree to include as soon as practically possible, but no later than the first new release of the Authorized Application following Your receipt of any 3D Landmarks, any copyright notices related to the display of such landmarks on every Authorized Application and in the “about box” of the Authorized Application. Notwithstanding the aforementioned, TomTom has the right to decide, at its sole discretion, to remove specific 3D Landmarks in subsequent releases of the Licensed Products. In such case, You will remove those 3D Landmarks from the Authorized Application as soon as practically possible, but not later than the first new release of the Authorized Application following Your receipt of the Update to the Licensed Product. TomTom shall not be held responsible for any possible damages, costs or expenses incurred by You related to such removal of a 3D Landmark by TomTom from the Licensed Product or failure to remove a 3D Landmark by You from the Authorized Application.",
36+
"TomTom hereby grants to You a non-exclusive, non-transferable license to use the Software Licensed Products for the sole and limited purpose of assisting You in viewing, analyzing and sectioning the Licensed Products. In no event shall You use the Software Licensed Products to view, analyze, section or in any way manipulate spatial map data that is not provided by TomTom. You shall not derive or attempt to derive the source code of all or any portion of the Licensed Products by reverse engineering, disassembly, decompilation, translation or any other means. You shall affix the following copyright notice on any copy of the GDF Viewer, or any portion of the Licensed Products: “Software ©2011-2020 TomTom North America, Inc. All rights reserved.",
37+
"Neither the Data nor the Licensed Products such as Speed Profiles or TomTom Traffic or any derivatives thereof shall be used for the purpose of enforcement of traffic laws including but not limited to the selection of potential locations for the installation of speed cameras, speed traps or other speed tracking devices. With regards to Speed Profiles, You acknowledge and agrees that the actual speeds may not reflect the legally imposed speed limits.",
38+
"You specifically agree that it shall not: (i) store the data for more than twenty-four (24) hours on Your servers; (ii) broadcast or make Live Services Licensed Products available except to authorized End Users; and (iii) use the feed or information received via the feed for historical data purposes (including but not limited to collection or analysis)."
39+
]
40+
}
41+
]
42+
}
43+
}
44+
}
45+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetCopyrightFromBoundingBox.json‎

Lines changed: 59 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,59 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"format": "json",
5+
"mincoordinates": [
6+
52.41064,
7+
4.84228
8+
],
9+
"maxcoordinates": [
10+
52.41072,
11+
4.84239
12+
],
13+
"text": "yes"
14+
},
15+
"responses": {
16+
"200": {
17+
"headers": {},
18+
"body": {
19+
"formatVersion": "0.0.1",
20+
"generalCopyrights": [
21+
"© 1992 - 2022 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection, database right protection and other intellectual property rights owned by TomTom or its suppliers. The use of this material is subject to the terms of a license agreement. Any unauthorized copying or disclosure of this material will lead to criminal and civil liabilities.",
22+
"Data Source © 2022 TomTom",
23+
"based on"
24+
],
25+
"regions": [
26+
{
27+
"country": {
28+
"ISO3": "NLD",
29+
"label": "Netherlands"
30+
},
31+
"copyrights": [
32+
"You agree to include as soon as practically possible, but no later than the first new release of the Authorized Application following Your receipt of any 3D Landmarks, any copyright notices related to the display of such landmarks on every Authorized Application and in the “about box” of the Authorized Application. Notwithstanding the aforementioned, TomTom has the right to decide, at its sole discretion, to remove specific 3D Landmarks in subsequent releases of the Licensed Products. In such case, You will remove those 3D Landmarks from the Authorized Application as soon as practically possible, but not later than the first new release of the Authorized Application following Your receipt of the Update to the Licensed Product. TomTom shall not be held responsible for any possible damages, costs or expenses incurred by You related to such removal of a 3D Landmark by TomTom from the Licensed Product or failure to remove a 3D Landmark by You from the Authorized Application.",
33+
"TomTom hereby grants to You a non-exclusive, non-transferable license to use the Software Licensed Products for the sole and limited purpose of assisting You in viewing, analyzing and sectioning the Licensed Products. In no event shall You use the Software Licensed Products to view, analyze, section or in any way manipulate spatial map data that is not provided by TomTom. You shall not derive or attempt to derive the source code of all or any portion of the Licensed Products by reverse engineering, disassembly, decompilation, translation or any other means. You shall affix the following copyright notice on any copy of the GDF Viewer, or any portion of the Licensed Products: “Software ©2011-2020 TomTom North America, Inc. All rights reserved.",
34+
"Neither the Data nor the Licensed Products such as Speed Profiles or TomTom Traffic or any derivatives thereof shall be used for the purpose of enforcement of traffic laws including but not limited to the selection of potential locations for the installation of speed cameras, speed traps or other speed tracking devices. With regards to Speed Profiles, You acknowledge and agrees that the actual speeds may not reflect the legally imposed speed limits.",
35+
"You specifically agree that it shall not: (i) store the data for more than twenty-four (24) hours on Your servers; (ii) broadcast or make Live Services Licensed Products available except to authorized End Users; and (iii) use the feed or information received via the feed for historical data purposes (including but not limited to collection or analysis).",
36+
"Contains data licensed under CC-BY 4.0. For more information visit: * Kadaster Top10NL http://nationaalgeoregister.nl/geonetwork/srv/dut/catalog.search#/metadata/29d5310f-dd0d-45ba-abad-b4ffc6b8785f?tab=general * Kadaster BGT http://nationaalgeoregister.nl/geonetwork/srv/dut/catalog.search#/metadata/2cb4769c-b56e-48fa-8685-c48f61b9a319?tab=general * CBS Bestand Bodemgebruik http://nationaalgeoregister.nl/geonetwork/srv/dut/catalog.search#/metadata/2d3dd6d2-2d2b-4b5f-9e30-86e19ed77a56?tab=general",
37+
"Contains data licensed under CC-BY 2.0. For more information visit: * Municipality of Amsterdam Datasets Parkeergarages https://data.amsterdam.nl/index.html#?dte=https:%2F%2Fapi.datapunt.amsterdam.nl%2Fcatalogus%2Fapi%2F3%2Faction%2Fpackage_show%3Fid%3Df06f5a77-04f6-432f-9fd9-ce9d740631aa&dtfs=T&mpb=topografie&mpz=9&mpv=52.3719:4.9012",
38+
"Contains data licensed under CC-BY 3.0. For more information visit: * Municipality of Amsterdam Multiple cat POI's https://data.amsterdam.nl/index.html#?dsd=dcatd&dsp=1&dsq=open%2520data&dsv=CATALOG&mpb=topografie&mpz=11&mpv=52.3731081:4.8932945",
39+
"This product contains public transport stops data made available under 9292 Open Data framework as documented on March 2013. This is specified in their terms available here: http://9292opendata.org/sla",
40+
"This product contains traffic incident information made available by NDW under open source data policy: https://www.ndw.nu/pagina/nl/103/datalevering/120/open_data/"
41+
]
42+
},
43+
{
44+
"country": {
45+
"ISO3": "ONL",
46+
"label": ""
47+
},
48+
"copyrights": [
49+
"You agree to include as soon as practically possible, but no later than the first new release of the Authorized Application following Your receipt of any 3D Landmarks, any copyright notices related to the display of such landmarks on every Authorized Application and in the “about box” of the Authorized Application. Notwithstanding the aforementioned, TomTom has the right to decide, at its sole discretion, to remove specific 3D Landmarks in subsequent releases of the Licensed Products. In such case, You will remove those 3D Landmarks from the Authorized Application as soon as practically possible, but not later than the first new release of the Authorized Application following Your receipt of the Update to the Licensed Product. TomTom shall not be held responsible for any possible damages, costs or expenses incurred by You related to such removal of a 3D Landmark by TomTom from the Licensed Product or failure to remove a 3D Landmark by You from the Authorized Application.",
50+
"TomTom hereby grants to You a non-exclusive, non-transferable license to use the Software Licensed Products for the sole and limited purpose of assisting You in viewing, analyzing and sectioning the Licensed Products. In no event shall You use the Software Licensed Products to view, analyze, section or in any way manipulate spatial map data that is not provided by TomTom. You shall not derive or attempt to derive the source code of all or any portion of the Licensed Products by reverse engineering, disassembly, decompilation, translation or any other means. You shall affix the following copyright notice on any copy of the GDF Viewer, or any portion of the Licensed Products: “Software ©2011-2020 TomTom North America, Inc. All rights reserved.",
51+
"Neither the Data nor the Licensed Products such as Speed Profiles or TomTom Traffic or any derivatives thereof shall be used for the purpose of enforcement of traffic laws including but not limited to the selection of potential locations for the installation of speed cameras, speed traps or other speed tracking devices. With regards to Speed Profiles, You acknowledge and agrees that the actual speeds may not reflect the legally imposed speed limits.",
52+
"You specifically agree that it shall not: (i) store the data for more than twenty-four (24) hours on Your servers; (ii) broadcast or make Live Services Licensed Products available except to authorized End Users; and (iii) use the feed or information received via the feed for historical data purposes (including but not limited to collection or analysis)."
53+
]
54+
}
55+
]
56+
}
57+
}
58+
}
59+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetMapAttribution.json‎

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,23 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"tilesetId": "microsoft.base",
5+
"zoom": 6,
6+
"bounds": [
7+
-122.414162,
8+
47.579490,
9+
-122.247157,
10+
47.668372
11+
]
12+
},
13+
"responses": {
14+
"200": {
15+
"headers": {},
16+
"body": {
17+
"copyrights": [
18+
"<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>"
19+
]
20+
}
21+
}
22+
}
23+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetMapStateTile.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"statesetId": "[statesetId]",
5+
"zoom": 6,
6+
"x": 10,
7+
"y": 22
8+
},
9+
"responses": {
10+
"200": {
11+
"headers": {
12+
"Content-Type": "application/vnd.mapbox-vector-tile"
13+
},
14+
"body": "{file}"
15+
}
16+
}
17+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetMapStaticImage.json‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"zoom": 10,
5+
"center": [
6+
-122.177621,
7+
47.613079
8+
],
9+
"tilesetId": "microsoft.base.road"
10+
},
11+
"responses": {
12+
"200": {
13+
"headers": {
14+
"Content-Type": "image/png"
15+
},
16+
"body": "{file}"
17+
}
18+
}
19+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetMapTile.json‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,17 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"tilesetId": "microsoft.base",
5+
"zoom": 6,
6+
"x": 10,
7+
"y": 22
8+
},
9+
"responses": {
10+
"200": {
11+
"headers": {
12+
"Content-Type": "application/vnd.mapbox-vector-tile"
13+
},
14+
"body": "binary image string"
15+
}
16+
}
17+
}

‎specification/maps/data-plane/Render/stable/2024-04-01/examples/Render_GetMapTileset.json‎

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
{
2+
"parameters": {
3+
"api-version": "2024-04-01",
4+
"tilesetId": "microsoft.base"
5+
},
6+
"responses": {
7+
"200": {
8+
"headers": {},
9+
"body": {
10+
"tilejson": "2.2.0",
11+
"version": "1.0.0",
12+
"attribution": "<a data-azure-maps-attribution-tileset=\"microsoft.base\">&copy;2022 TomTom</a>",
13+
"scheme": "xyz",
14+
"tiles": [
15+
"https://atlas.microsoft.com/map/tile?api-version=2024-04-01&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
16+
],
17+
"minzoom": 0,
18+
"maxzoom": 22,
19+
"bounds": [
20+
-180.0,
21+
-90.0,
22+
180.0,
23+
90.0
24+
]
25+
}
26+
}
27+
}
28+
}

0 commit comments

Comments
 (0)