Thanks to visit codestin.com
Credit goes to github.com

Skip to content

Commit 4d61f90

Browse files
ambientlightambientlight
authored
[Hub Generated] Review request for Render to add version preview/2.1 (Azure#15411)
* render updates based on Azure#14625 * GetAttribution response codes * remove common error responses * go multiapi batch should include 2.0 * fix openapi 3.0 definition of file response, keep content-type * keep operationId between 2.0 and 2.1 * update samples and header response * exclude 2.0 from 2.1-preview tag, refs in 2.1 params, remove used Text param * refrain from changing 2.0 timestamp format * remove default in tileSize * remove redundant required: false * bump python package version * make sure there is no cross-client parameter references - move all shared into Common * remove non-supported application/xml MIME * use local apiversion param def
1 parent 633cc8d commit 4d61f90

File tree

11 files changed

+491
-43
lines changed

11 files changed

+491
-43
lines changed

‎specification/maps/data-plane/Common/preview/1.0/common.json‎

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -540,6 +540,13 @@
540540
"in": "header",
541541
"x-ms-parameter-location": "client"
542542
},
543+
"Language": {
544+
"name": "language",
545+
"in": "query",
546+
"description": "Language in which search results should be returned. Should be one of supported IETF language tags, case insensitive. When data in specified language is not available for a specific field, default language is used.\n\nPlease refer to [Supported Languages](https://docs.microsoft.com/en-us/azure/azure-maps/supported-languages) for details.",
547+
"type": "string",
548+
"x-ms-parameter-location": "method"
549+
},
543550
"ResponseFormat": {
544551
"name": "format",
545552
"description": "Desired format of the response. Only `json` format is supported.",
@@ -613,6 +620,33 @@
613620
]
614621
},
615622
"x-ms-parameter-location": "client"
623+
},
624+
"View": {
625+
"name": "view",
626+
"in": "query",
627+
"description": "The View parameter specifies which set of geopolitically disputed content is returned via Azure Maps services, including borders and labels displayed on the map. The View parameter (also referred to as “user region parameter”) will show the correct maps for that country/region. By default, the View parameter is set to “Unified” even if you haven’t defined it in the request. It is your responsibility to determine the location of your users, and then set the View parameter correctly for that location. Alternatively, you have the option to set ‘View=Auto’, which will return the map data based on the IP address of the request. The View parameter in Azure Maps must be used in compliance with applicable laws, including those regarding mapping, of the country where maps, images and other data and third party content that you are authorized to access via Azure Maps is made available. Example: view=IN.\n\nPlease refer to [Supported Views](https://aka.ms/AzureMapsLocalizationViews) for details and to see the available Views.",
628+
"type": "string",
629+
"x-ms-parameter-location": "method"
630+
},
631+
"xTileIndex": {
632+
"name": "x",
633+
"x-ms-client-name": "xTileIndex",
634+
"in": "query",
635+
"description": "X coordinate of the tile on zoom grid. Value must be in the range [0, 2<sup>`zoom`</sup> -1].\n\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
636+
"required": true,
637+
"type": "integer",
638+
"format": "int32",
639+
"x-ms-parameter-location": "method"
640+
},
641+
"yTileIndex": {
642+
"name": "y",
643+
"x-ms-client-name": "yTileIndex",
644+
"in": "query",
645+
"description": "Y coordinate of the tile on zoom grid. Value must be in the range [0, 2<sup>`zoom`</sup> -1].\n\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
646+
"required": true,
647+
"type": "integer",
648+
"format": "int32",
649+
"x-ms-parameter-location": "method"
616650
}
617651
},
618652
"responses": {

‎specification/maps/data-plane/Render/preview/1.0/render.json‎

Lines changed: 12 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -105,26 +105,6 @@
105105
},
106106
"x-ms-parameter-location": "method"
107107
},
108-
"xTileIndex": {
109-
"name": "x",
110-
"x-ms-client-name": "xTileIndex",
111-
"in": "query",
112-
"description": "X coordinate of the tile on zoom grid. Value must be in the range [0, 2<sup>`zoom`</sup> -1].\n\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
113-
"required": true,
114-
"type": "integer",
115-
"format": "int32",
116-
"x-ms-parameter-location": "method"
117-
},
118-
"yTileIndex": {
119-
"name": "y",
120-
"x-ms-client-name": "yTileIndex",
121-
"in": "query",
122-
"description": "Y coordinate of the tile on zoom grid. Value must be in the range [0, 2<sup>`zoom`</sup> -1].\n\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
123-
"required": true,
124-
"type": "integer",
125-
"format": "int32",
126-
"x-ms-parameter-location": "method"
127-
},
128108
"RasterZoom18": {
129109
"name": "zoom",
130110
"in": "query",
@@ -300,10 +280,10 @@
300280
"maximum": 8192
301281
},
302282
{
303-
"$ref": "../../../Search/preview/1.0/search.json#/parameters/Language"
283+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
304284
},
305285
{
306-
"$ref": "../../../Search/preview/1.0/search.json#/parameters/View"
286+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/View"
307287
},
308288
{
309289
"name": "pins",
@@ -442,10 +422,10 @@
442422
"$ref": "#/parameters/RasterVectorNaturalEarthZoom"
443423
},
444424
{
445-
"$ref": "#/parameters/xTileIndex"
425+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
446426
},
447427
{
448-
"$ref": "#/parameters/yTileIndex"
428+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
449429
},
450430
{
451431
"name": "tileSize",
@@ -472,10 +452,10 @@
472452
}
473453
},
474454
{
475-
"$ref": "../../../Search/preview/1.0/search.json#/parameters/Language"
455+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
476456
},
477457
{
478-
"$ref": "../../../Search/preview/1.0/search.json#/parameters/View"
458+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/View"
479459
}
480460
],
481461
"produces": [
@@ -526,10 +506,10 @@
526506
"$ref": "#/parameters/VectorZoom"
527507
},
528508
{
529-
"$ref": "#/parameters/xTileIndex"
509+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
530510
},
531511
{
532-
"$ref": "#/parameters/yTileIndex"
512+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
533513
},
534514
{
535515
"name": "statesetId",
@@ -640,10 +620,10 @@
640620
"$ref": "#/parameters/ImageryRasterZoom"
641621
},
642622
{
643-
"$ref": "#/parameters/xTileIndex"
623+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
644624
},
645625
{
646-
"$ref": "#/parameters/yTileIndex"
626+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
647627
}
648628
],
649629
"produces": [
@@ -745,10 +725,10 @@
745725
"$ref": "#/parameters/RasterZoom18"
746726
},
747727
{
748-
"$ref": "#/parameters/xTileIndex"
728+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
749729
},
750730
{
751-
"$ref": "#/parameters/yTileIndex"
731+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
752732
},
753733
{
754734
"$ref": "#/parameters/IncludeText"

‎specification/maps/data-plane/Render/preview/2.0/render.json‎

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -76,7 +76,8 @@
7676
"microsoft.imagery",
7777
"microsoft.weather.radar.main",
7878
"microsoft.weather.infrared.main",
79-
"microsoft.dem"
79+
"microsoft.dem",
80+
"microsoft.dem.contours"
8081
],
8182
"x-ms-enum": {
8283
"name": "TilesetID",
@@ -129,6 +130,10 @@
129130
{
130131
"value": "microsoft.dem",
131132
"description": "Digital Elevation Model tiles. The tiles are in the GeoTIFF format with a single 32-bit floating point band. The tiles cover the whole landmass of Earth. Some small islands (e.g., atolls) might not be represented accurately.<br>\n* The vertical unit for measurement of elevation height is meters. An elevation value of -32767.0 is used for points that have no data value, most often returned where there isn't landmass (i.e. water).<br>\n* The horizontal reference datum is the World Geodetic System 1984 (WGS84-G1150) and the vertical reference datum is the Earth Gravitational Model 2008 (EGM2008).<br>\n* Tiles are 258x258 pixel squares rather than the standard 256 x 256. This is done to allow for accurate interpolation of values at the tile edges. As such adjacent tiles overlap by 1 pixel along all edges.<br>\n* Tile data comes from the [Airbus WorldDEM4Ortho product](https://www.intelligence-airbusds.com/worlddem-streaming/). Urban areas are approximately leveled down to ground level. All other areas are represented by the object surface level (e.g., trees). <br>\n\nSupports zoom level 13 only. Format: raster (tiff)."
133+
},
134+
{
135+
"value": "microsoft.dem.contours",
136+
"description": "Digital elevation contour line tiles. Compared to the microsoft.dem option, these tiles are in vector format and intended for visualization purpose. The tiles cover the whole landmass of Earth. Some small islands (e.g., atolls) might not be represented accurately.<br>\n* The vertical unit for measurement of elevation height is meters.<br>\n* The horizontal reference datum is the World Geodetic System 1984 (WGS84-G1150) and the vertical reference datum is the Earth Gravitational Model 2008 (EGM2008).<br>\n* Tile data comes from the [Airbus WorldDEM4Ortho product](https://www.intelligence-airbusds.com/worlddem-streaming/). Urban areas are approximately leveled down to ground level. All other areas are represented by the object surface level (e.g., trees).<br>\n\nSupports zoom levels 9 through 14. Format: vector (pbf)."
132137
}
133138
]
134139
},
@@ -168,10 +173,10 @@
168173
"$ref": "#/parameters/MapTileV2Zoom"
169174
},
170175
{
171-
"$ref": "../1.0/render.json#/parameters/xTileIndex"
176+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
172177
},
173178
{
174-
"$ref": "../1.0/render.json#/parameters/yTileIndex"
179+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
175180
},
176181
{
177182
"name": "timeStamp",
@@ -205,10 +210,10 @@
205210
}
206211
},
207212
{
208-
"$ref": "../../../Search/preview/1.0/search.json#/parameters/Language"
213+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
209214
},
210215
{
211-
"$ref": "../../../Search/preview/1.0/search.json#/parameters/View"
216+
"$ref": "../../../Common/preview/1.0/common.json#/parameters/View"
212217
}
213218
],
214219
"produces": [

‎specification/maps/data-plane/Render/preview/2.1/examples/GetMapAttributionV2.json‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
{
2+
"parameters": {
3+
"api-version": "2.1",
4+
"tilesetId": "microsoft.base",
5+
"zoom": 6,
6+
"bounds": "-122.414162,47.579490,-122.247157,47.668372"
7+
},
8+
"responses": {
9+
"200": {
10+
"headers": {},
11+
"body": {
12+
"copyrights": [
13+
"<a>&copy; 2021 TomTom</a>"
14+
]
15+
}
16+
}
17+
}
18+
}

‎specification/maps/data-plane/Render/preview/2.1/examples/GetMapTileV2.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": "2.1",
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": "{file}"
15+
}
16+
}
17+
}

‎specification/maps/data-plane/Render/preview/2.1/examples/GetMapTilesetV2.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": "2.1",
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>&copy; 2021 TomTom</a>",
13+
"scheme": "xyz",
14+
"tiles": [
15+
"https://atlas.microsoft.com/map/tile?api-version=2.0&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
16+
],
17+
"minzoom": 0,
18+
"maxzoom": 22,
19+
"bounds": [
20+
-180,
21+
-90,
22+
180,
23+
90
24+
]
25+
}
26+
}
27+
}
28+
}

0 commit comments

Comments
 (0)