Skip to content

Commit

Permalink
render updates based on Azure#14625
Browse files Browse the repository at this point in the history
  • Loading branch information
ambientlight committed Jul 28, 2021
1 parent 2b4fc08 commit 4dfbfbd
Show file tree
Hide file tree
Showing 8 changed files with 804 additions and 6 deletions.
14 changes: 14 additions & 0 deletions specification/maps/data-plane/Common/preview/1.0/common.json
Original file line number Diff line number Diff line change
Expand Up @@ -539,6 +539,13 @@
"in": "header",
"x-ms-parameter-location": "client"
},
"Language": {
"name": "language",
"in": "query",
"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.",
"type": "string",
"x-ms-parameter-location": "method"
},
"ResponseFormat": {
"name": "format",
"description": "Desired format of the response. Only `json` format is supported.",
Expand Down Expand Up @@ -612,6 +619,13 @@
]
},
"x-ms-parameter-location": "client"
},
"View": {
"name": "view",
"in": "query",
"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.",
"type": "string",
"x-ms-parameter-location": "method"
}
},
"responses": {
Expand Down
65 changes: 61 additions & 4 deletions specification/maps/data-plane/Render/preview/2.0/render.json
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,44 @@
"AzureKey": []
}
],
"responses": {},
"responses": {
"400": {
"description": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.",
"schema": {
"$ref": "../../../../../common-types/data-plane/v1/types.json#/definitions/ErrorResponse"
}
},
"401": {
"description": "Access denied due to invalid subscription key or invalid Azure Active Directory bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#section-3.1) header for error code and description of the provided AAD bearer token.",
"schema": {
"$ref": "../../../../../common-types/data-plane/v1/types.json#/definitions/ErrorResponse"
},
"headers": {
"WWW-Authenticate": {
"type": "string",
"description": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\""
}
}
},
"403": {
"description": "Permission, capacity, or authentication issues.",
"schema": {
"$ref": "../../../../../common-types/data-plane/v1/types.json#/definitions/ErrorResponse"
}
},
"404": {
"description": "Not Found: the requested resource could not be found, but it may be available again in the future.",
"schema": {
"$ref": "../../../../../common-types/data-plane/v1/types.json#/definitions/ErrorResponse"
}
},
"500": {
"description": "An error occurred while processing the request. Please try again later.",
"schema": {
"$ref": "../../../../../common-types/data-plane/v1/types.json#/definitions/ErrorResponse"
}
}
},
"parameters": {
"RenderApiVersionV2": {
"name": "api-version",
Expand Down Expand Up @@ -76,7 +113,8 @@
"microsoft.imagery",
"microsoft.weather.radar.main",
"microsoft.weather.infrared.main",
"microsoft.dem"
"microsoft.dem",
"microsoft.dem.contours"
],
"x-ms-enum": {
"name": "TilesetID",
Expand Down Expand Up @@ -129,6 +167,10 @@
{
"value": "microsoft.dem",
"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)."
},
{
"value": "microsoft.dem.contours",
"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)."
}
]
},
Expand Down Expand Up @@ -204,10 +246,10 @@
}
},
{
"$ref": "../../../Search/preview/1.0/search.json#/parameters/Language"
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
},
{
"$ref": "../../../Search/preview/1.0/search.json#/parameters/View"
"$ref": "../../../Common/preview/1.0/common.json#/parameters/View"
}
],
"produces": [
Expand All @@ -232,6 +274,21 @@
}
}
},
"400": {
"$ref": "#/responses/400"
},
"401": {
"$ref": "#/responses/401"
},
"403": {
"$ref": "#/responses/403"
},
"404": {
"$ref": "#/responses/404"
},
"500": {
"$ref": "#/responses/500"
},
"default": {
"$ref": "../../../Common/preview/1.0/common.json#/responses/default"
}
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,63 @@
{
"parameters": {
"api-version": "2.1",
"tilesetId": "microsoft.base",
"zoom": 6,
"bounds": "-122.414162,47.579490,-122.247157,47.668372"
},
"responses": {
"200": {
"headers": {},
"body": {
"copyrights": [
"<a>&copy; 2021 TomTom</a>"
]
}
},
"400": {
"headers": {},
"body": {
"error": {
"code": "400 BadRequest",
"message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
}
}
},
"401": {
"headers": {},
"body": {
"error": {
"code": "401 Unauthorized",
"message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}
}
},
"403": {
"headers": {},
"body": {
"error": {
"code": "403 Forbidden",
"message": "Permission, capacity, or authentication issues."
}
}
},
"404": {
"headers": {},
"body": {
"error": {
"code": "404 NotFound",
"message": "Not Found: the requested resource could not be found, but it may be available again in the future."
}
}
},
"500": {
"headers": {},
"body": {
"error": {
"code": "500 InternalServerError",
"message": "An error occurred while processing the request. Please try again later."
}
}
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,60 @@
{
"parameters": {
"api-version": "2.1",
"tilesetId": "microsoft.base",
"zoom": 6,
"x": 10,
"y": 22
},
"responses": {
"200": {
"headers": {},
"body": "binary string image"
},
"400": {
"headers": {},
"body": {
"error": {
"code": "400 BadRequest",
"message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
}
}
},
"401": {
"headers": {},
"body": {
"error": {
"code": "401 Unauthorized",
"message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}
}
},
"403": {
"headers": {},
"body": {
"error": {
"code": "403 Forbidden",
"message": "Permission, capacity, or authentication issues."
}
}
},
"404": {
"headers": {},
"body": {
"error": {
"code": "404 NotFound",
"message": "Not Found: the requested resource could not be found, but it may be available again in the future."
}
}
},
"500": {
"headers": {},
"body": {
"error": {
"code": "500 InternalServerError",
"message": "An error occurred while processing the request. Please try again later."
}
}
}
}
}
Original file line number Diff line number Diff line change
@@ -0,0 +1,73 @@
{
"parameters": {
"api-version": "2.1",
"tilesetId": "microsoft.base"
},
"responses": {
"200": {
"headers": {},
"body": {
"tilejson": "2.2.0",
"version": "1.0.0",
"attribution": "<a>&copy; 2021 TomTom</a>",
"scheme": "xyz",
"tiles": [
"https://atlas.microsoft.com/map/tile?api-version=2.0&tilesetId={tilesetId}&zoom={zoom}&x={x}&y={y}"
],
"minzoom": 0,
"maxzoom": 22,
"bounds": [
-180,
-90,
180,
90
]
}
},
"400": {
"headers": {},
"body": {
"error": {
"code": "400 BadRequest",
"message": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive."
}
}
},
"401": {
"headers": {},
"body": {
"error": {
"code": "401 Unauthorized",
"message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}
}
},
"403": {
"headers": {},
"body": {
"error": {
"code": "403 Forbidden",
"message": "Permission, capacity, or authentication issues."
}
}
},
"404": {
"headers": {},
"body": {
"error": {
"code": "404 NotFound",
"message": "Not Found: the requested resource could not be found, but it may be available again in the future."
}
}
},
"500": {
"headers": {},
"body": {
"error": {
"code": "500 InternalServerError",
"message": "An error occurred while processing the request. Please try again later."
}
}
}
}
}
Loading

0 comments on commit 4dfbfbd

Please sign in to comment.