diff --git a/custom-words.txt b/custom-words.txt
index 2a714734db49..1c2d0fe39019 100644
--- a/custom-words.txt
+++ b/custom-words.txt
@@ -343,6 +343,7 @@ checkin
checkmark
checknameavailability
checkpointing
+Chttp
CIDR
CIDRs
CIFS
@@ -710,6 +711,7 @@ FarmBeats
fatherable
faultable
fconfig
+Fcontoso
FDID
fearthecowboy
featurecapabilities
@@ -744,6 +746,7 @@ forceclosehandles
forestsummary
formrecognizer
FPGA
+Fpushpins
fqdn
FQDNs
Français
diff --git a/specification/maps/data-plane/Common/preview/1.0/common.json b/specification/maps/data-plane/Common/preview/1.0/common.json
index f309474dceba..f73bf0478f3a 100644
--- a/specification/maps/data-plane/Common/preview/1.0/common.json
+++ b/specification/maps/data-plane/Common/preview/1.0/common.json
@@ -727,22 +727,65 @@
},
"xTileIndex": {
"name": "x",
- "x-ms-client-name": "xTileIndex",
"in": "query",
"description": "X coordinate of the tile on zoom grid. Value must be in the range [0, 2`zoom` -1].\n\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
"required": true,
"type": "integer",
"format": "int32",
- "x-ms-parameter-location": "method"
+ "x-ms-parameter-location": "method",
+ "x-ms-parameter-grouping": {
+ "name": "tileIndex"
+ }
},
"yTileIndex": {
"name": "y",
- "x-ms-client-name": "yTileIndex",
"in": "query",
"description": "Y coordinate of the tile on zoom grid. Value must be in the range [0, 2`zoom` -1].\n\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
"required": true,
"type": "integer",
"format": "int32",
+ "x-ms-parameter-location": "method",
+ "x-ms-parameter-grouping": {
+ "name": "tileIndex"
+ }
+ },
+ "zTileIndex": {
+ "name": "zoom",
+ "x-ms-client-name": "z",
+ "in": "query",
+ "description": "Zoom level for the desired tile. \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.",
+ "required": true,
+ "type": "integer",
+ "format": "int32",
+ "x-ms-parameter-location": "method",
+ "x-ms-parameter-grouping": {
+ "name": "tileIndex"
+ }
+ },
+ "IncludeText": {
+ "name": "text",
+ "x-ms-client-name": "includeText",
+ "in": "query",
+ "description": "Yes/no value to exclude textual data from response. Only images and country names will be in response.",
+ "type": "string",
+ "enum": [
+ "yes",
+ "no"
+ ],
+ "x-ms-enum": {
+ "name": "IncludeText",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "yes",
+ "description": "Include all textual data in response."
+ },
+ {
+ "value": "no",
+ "description": "Exclude textual data from response. Only images and country names will be in response."
+ }
+ ]
+ },
"x-ms-parameter-location": "method"
}
},
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightFromBoundingBox.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulBoundingBoxCopyrightRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightFromBoundingBox.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulBoundingBoxCopyrightRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightCaption.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulCopyrightCaptionRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightCaption.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulCopyrightCaptionRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetMapImageryTile.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulImageryTileRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetMapImageryTile.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulImageryTileRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetMapStateTile.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulStateTileRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetMapStateTile.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulStateTileRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetMapStaticImage.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulStaticImageRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetMapStaticImage.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulStaticImageRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightForTile.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulTileCopyrightRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightForTile.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulTileCopyrightRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetMapTile.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulTileRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetMapTile.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulTileRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightForWorld.json b/specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulWorldCopyrightRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/1.0/examples/GetCopyrightForWorld.json
rename to specification/maps/data-plane/Render/preview/1.0/examples/SuccessfulWorldCopyrightRequest.json
diff --git a/specification/maps/data-plane/Render/preview/1.0/render.json b/specification/maps/data-plane/Render/preview/1.0/render.json
index 22f2fcf88e30..3dc906369b2d 100644
--- a/specification/maps/data-plane/Render/preview/1.0/render.json
+++ b/specification/maps/data-plane/Render/preview/1.0/render.json
@@ -57,6 +57,7 @@
"type": "string",
"in": "path",
"required": true,
+ "x-ms-client-default": "png",
"enum": [
"png"
],
@@ -72,6 +73,33 @@
},
"x-ms-parameter-location": "method"
},
+ "MapTileSize": {
+ "name": "tileSize",
+ "in": "query",
+ "description": "The size of the returned map tile in pixels.",
+ "type": "string",
+ "enum": [
+ "256",
+ "512"
+ ],
+ "x-ms-enum": {
+ "name": "MapTileSize",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "256",
+ "name": "size256",
+ "description": "Return a 256 by 256 pixel tile."
+ },
+ {
+ "value": "512",
+ "name": "size512",
+ "description": "Return a 512 by 512 pixel tile."
+ }
+ ]
+ },
+ "x-ms-parameter-location": "method"
+ },
"TileFormat": {
"name": "format",
"description": "Desired format of the response. Possible values are png & pbf.",
@@ -98,66 +126,39 @@
},
"x-ms-parameter-location": "method"
},
- "RasterZoom18": {
- "name": "zoom",
+ "BoundingBoxSouthWest": {
+ "name": "mincoordinates",
+ "x-ms-client-name": "southWest",
"in": "query",
- "description": "Zoom level for the desired tile. Zoom value must be in the range: 0-18 (inclusive).\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.",
+ "description": "Minimum coordinates (south-west point) of bounding box in latitude longitude coordinate system. E.g. 52.41064,4.84228",
"required": true,
- "type": "integer",
- "format": "int32",
- "x-ms-parameter-location": "method"
- },
- "VectorZoom": {
- "name": "zoom",
- "in": "query",
- "description": "Zoom level for the desired tile. Zoom value must be in the range: 0-20 (inclusive).\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.",
- "required": true,
- "type": "integer",
- "format": "int32",
- "x-ms-parameter-location": "method"
- },
- "ImageryRasterZoom": {
- "name": "zoom",
- "in": "query",
- "description": "Zoom level for the desired tile. Zoom value must be in the range: 1-19 (inclusive).\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
- "required": true,
- "type": "integer",
- "format": "int32",
- "x-ms-parameter-location": "method"
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
+ },
+ "collectionFormat": "csv",
+ "x-ms-parameter-location": "method",
+ "x-ms-parameter-grouping": {
+ "name": "BoundingBox"
+ }
},
- "RasterVectorNaturalEarthZoom": {
- "name": "zoom",
+ "BoundingBoxNorthEast": {
+ "name": "maxcoordinates",
+ "x-ms-client-name": "northEast",
"in": "query",
- "description": "Zoom level for the desired tile. For _raster_ tiles, value must be in the range: 0-18 (inclusive). Terra raster tiles, values must be in the range 0-6 (inclusive). For _vector_ tiles, value must be in the range: 0-22 (inclusive).\nPlease see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
+ "description": "Maximum coordinates (north-east point) of bounding box in latitude longitude coordinate system. E.g. 52.41064,4.84228",
"required": true,
- "type": "integer",
- "format": "int32",
- "x-ms-parameter-location": "method"
- },
- "IncludeText": {
- "name": "text",
- "in": "query",
- "description": "Yes/no value to exclude textual data from response. Only images and country names will be in response.",
- "type": "string",
- "enum": [
- "yes",
- "no"
- ],
- "x-ms-enum": {
- "name": "IncludeText",
- "modelAsString": true,
- "values": [
- {
- "value": "yes",
- "description": "Include all textual data in response."
- },
- {
- "value": "no",
- "description": "Exclude textual data from response. Only images and country names will be in response."
- }
- ]
+ "type": "array",
+ "items": {
+ "type": "number",
+ "format": "double"
},
- "x-ms-parameter-location": "method"
+ "collectionFormat": "csv",
+ "x-ms-parameter-location": "method",
+ "x-ms-parameter-grouping": {
+ "name": "BoundingBox"
+ }
}
},
"paths": {
@@ -166,8 +167,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nThe static image service renders a user-defined, rectangular image containing a map section using a zoom level from 0 to 20. The static image service renders a user-defined, rectangular image containing a map section using a zoom level from 0 to 20. The supported resolution range for the map image is from 1x1 to 8192x8192. If you are deciding when to use the static image service over the map tile service, you may want to consider how you would like to interact with the rendered map. If the map contents will be relatively unchanging, a static map is a good choice. If you want to support a lot of zooming, panning and changing of the map content, the map tile service would be a better choice. \n\nService also provides Image Composition functionality to get a static image back with additional data like; pushpins and geometry overlays with following S0 and S1 capabilities. \n\nIn S0 you can:\n- Render up to 5 pushpins specified in the request\n- Provide one custom image for the pins referenced in the request\n- Add labels to the pushpins\n\nIn S1 you can:\n- Render pushpins through [Azure Maps Data Service](https://aka.ms/AzureMapsMapDataService)\n- Specify multiple pushpin styles\n- Render circle, polyline and polygon geometry types.\n- Render of supported GeoJSON geometry types uploaded through [Azure Maps Data Service](https://aka.ms/AzureMapsMapDataService)\n\nPlease see [How-to-Guide](https://aka.ms/AzureMapsHowToGuideImageCompositor) for detailed examples.\n\n_Note_ : Either **center** or **bbox** parameter must be supplied to the\nAPI.\n
\nThe supported Lat and Lon ranges when using the **bbox** parameter, are as follows:\n
\n\n |Zoom Level | Max Lon Range | Max Lat Range|\n |:----------|:----------------|:-------------|\n |0 | 360.0 | 170.0 | \n |1 | 360.0 | 170.0 |\n |2 | 360.0 | 170.0 |\n |3 | 360.0 | 170.0 |\n |4 | 360.0 | 170.0 |\n |5 | 180.0 | 85.0 |\n |6 | 90.0 | 42.5 |\n |7 | 45.0 | 21.25 |\n |8 | 22.5 | 10.625 |\n |9 | 11.25 | 5.3125 |\n |10 | 5.625 | 2.62625 |\n |11 | 2.8125 | 1.328125 |\n |12 | 1.40625 | 0.6640625 |\n |13 | 0.703125 | 0.33203125 |\n |14 | 0.3515625 | 0.166015625 |\n |15 | 0.17578125 | 0.0830078125 | \n |16 | 0.087890625 | 0.0415039063 | \n |17 | 0.0439453125 | 0.0207519531 |\n |18 | 0.0219726563 | 0.0103759766 |\n |19 | 0.0109863281 | 0.0051879883 |\n |20 | 0.0054931641 | 0.0025939941 |",
"operationId": "GetMapStaticImage",
"x-ms-examples": {
- "GetMapStaticImage": {
- "$ref": "./examples/GetMapStaticImage.json"
+ "Successful Static Image Request": {
+ "$ref": "./examples/SuccessfulStaticImageRequest.json"
}
},
"parameters": [
@@ -246,13 +247,24 @@
"name": "center",
"in": "query",
"description": "Coordinates of the center point. Format: 'lon,lat'. Projection used\n- EPSG:3857. Longitude range: -180 to 180. Latitude range: -85 to 85. \n\nNote: Either center or bbox are required parameters. They are\nmutually exclusive.",
- "type": "string"
+ "type": "array",
+ "collectionFormat": "csv",
+ "items": {
+ "type": "number",
+ "format": "double"
+ }
},
{
"name": "bbox",
+ "x-ms-client-name": "boundingBox",
"in": "query",
"description": "Bounding box. Projection used - EPSG:3857. Format : 'minLon, minLat,\nmaxLon, maxLat'. \n\nNote: Either bbox or center are required\nparameters. They are mutually exclusive. It shouldn’t be used with\nheight or width.\n\nThe maximum allowed ranges for Lat and Lon are defined for each zoom level\nin the table at the top of this page.",
- "type": "string"
+ "type": "array",
+ "collectionFormat": "csv",
+ "items": {
+ "type": "number",
+ "format": "double"
+ }
},
{
"name": "height",
@@ -332,8 +344,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nFetches map tiles in vector or raster format typically to be integrated into a new map control or SDK. By default, Azure uses vector map tiles for its web map control (see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid))\n\n**Note**: Weather tiles are only available via [Get Map Tile V2 API](https://aka.ms/AzureMapsWeatherTiles). We recommend to start to use the new [Get Map Tile V2 API](https://aka.ms/GetMapTileV2).",
"operationId": "GetMapTile",
"x-ms-examples": {
- "GetMapTile": {
- "$ref": "./examples/GetMapTile.json"
+ "Successful Tile Request": {
+ "$ref": "./examples/SuccessfulTileRequest.json"
}
},
"parameters": [
@@ -412,7 +424,7 @@
}
},
{
- "$ref": "#/parameters/RasterVectorNaturalEarthZoom"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
@@ -421,28 +433,7 @@
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
},
{
- "name": "tileSize",
- "in": "query",
- "description": "The size of the returned map tile in pixels.",
- "type": "string",
- "enum": [
- "256",
- "512"
- ],
- "x-ms-enum": {
- "name": "MapTileSize",
- "modelAsString": true,
- "values": [
- {
- "value": "256",
- "description": "Return a 256 by 256 pixel tile."
- },
- {
- "value": "512",
- "description": "Return a 512 by 512 pixel tile."
- }
- ]
- }
+ "$ref": "#/parameters/MapTileSize"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
@@ -484,8 +475,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nFetches state tiles in vector format typically to be integrated into indoor maps module of map control or SDK. The map control will call this API after user turns on dynamic styling (see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid))",
"operationId": "GetMapStateTile",
"x-ms-examples": {
- "GetMapStateTile": {
- "$ref": "./examples/GetMapStateTile.json"
+ "Successful State Tile Request": {
+ "$ref": "./examples/SuccessfulStateTileRequest.json"
}
},
"parameters": [
@@ -496,7 +487,7 @@
"$ref": "#/parameters/ApiVersion"
},
{
- "$ref": "#/parameters/VectorZoom"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
@@ -542,8 +533,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\n\nCopyrights API is designed to serve copyright information for Render Tile \nservice. In addition to basic copyright for the whole map, API is serving \nspecific groups of copyrights for some countries.\n\nAs an alternative to copyrights for map request, one can receive captions\nfor displaying the map provider information on the map.",
"operationId": "GetCopyrightCaption",
"x-ms-examples": {
- "GetCopyrightCaption": {
- "$ref": "./examples/GetCopyrightCaption.json"
+ "Successful Copyright Caption Request": {
+ "$ref": "./examples/SuccessfulCopyrightCaptionRequest.json"
}
},
"parameters": [
@@ -561,7 +552,7 @@
"200": {
"description": "OK",
"schema": {
- "$ref": "#/definitions/GetCopyrightCaptionResult"
+ "$ref": "#/definitions/CopyrightCaption"
}
},
"default": {
@@ -575,8 +566,8 @@
"description": "**Applies to:** S1 pricing tier.\n\n\nThis service returns a map image tile with size 256x256, given the x and y coordinates and zoom\nlevel. Zoom level ranges from 1 to 19. The current available style value is 'satellite' which provides satellite\nimagery alone.\n\n\n**Note**: We recommend to start to use the new [Get Map Tile V2 API](https://aka.ms/GetMapTileV2).",
"operationId": "GetMapImageryTile",
"x-ms-examples": {
- "GetMapImageryTile": {
- "$ref": "./examples/GetMapImageryTile.json"
+ "Successful Imagery Tile Request": {
+ "$ref": "./examples/SuccessfulImageryTileRequest.json"
}
},
"parameters": [
@@ -595,6 +586,7 @@
"description": "Map style to be returned. __Possible values:__ satellite.",
"required": true,
"type": "string",
+ "x-ms-client-default": "satellite",
"enum": [
"satellite"
],
@@ -610,7 +602,7 @@
}
},
{
- "$ref": "#/parameters/ImageryRasterZoom"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
@@ -650,8 +642,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nReturns copyright information for a given bounding box. Bounding-box requests should specify the minimum and maximum longitude and latitude (EPSG-3857) coordinates",
"operationId": "GetCopyrightFromBoundingBox",
"x-ms-examples": {
- "GetCopyrightFromBoundingBox": {
- "$ref": "./examples/GetCopyrightFromBoundingBox.json"
+ "Successful Bounding Box Copyright Request": {
+ "$ref": "./examples/SuccessfulBoundingBoxCopyrightRequest.json"
}
},
"parameters": [
@@ -662,31 +654,23 @@
"$ref": "#/parameters/ApiVersion"
},
{
- "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
+ "$ref": "#/parameters/BoundingBoxSouthWest"
},
{
- "name": "mincoordinates",
- "in": "query",
- "description": "Minimum coordinates of bounding box in latitude longitude coordinate system. E.g. 52.41064,4.84228",
- "required": true,
- "type": "string"
+ "$ref": "#/parameters/BoundingBoxNorthEast"
},
{
- "name": "maxcoordinates",
- "in": "query",
- "description": "Maximum coordinates of bounding box in latitude longitude coordinate system. E.g. 52.41064,4.84228",
- "required": true,
- "type": "string"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
},
{
- "$ref": "#/parameters/IncludeText"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/IncludeText"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
- "$ref": "#/definitions/GetCopyrightFromBoundingBoxResult"
+ "$ref": "#/definitions/Copyright"
}
},
"default": {
@@ -700,8 +684,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\n\nCopyrights API is designed to serve copyright information for Render Tile service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries.\nReturns the copyright information for a given tile. To obtain the copyright information for a particular tile, the request should specify the tile's zoom level and x and y coordinates (see: Zoom Levels and Tile Grid).",
"operationId": "GetCopyrightForTile",
"x-ms-examples": {
- "GetCopyrightForTile": {
- "$ref": "./examples/GetCopyrightForTile.json"
+ "Successful Tile Copyright Request": {
+ "$ref": "./examples/SuccessfulTileCopyrightRequest.json"
}
},
"parameters": [
@@ -712,10 +696,7 @@
"$ref": "#/parameters/ApiVersion"
},
{
- "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
- },
- {
- "$ref": "#/parameters/RasterZoom18"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
@@ -724,14 +705,17 @@
"$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
},
{
- "$ref": "#/parameters/IncludeText"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/IncludeText"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
- "$ref": "#/definitions/GetCopyrightForTileResult"
+ "$ref": "#/definitions/Copyright"
}
},
"default": {
@@ -745,8 +729,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nCopyrights API is designed to serve copyright information for Render Tile service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries.\nReturns the copyright information for the world. To obtain the default copyright information for the whole world, do not specify a tile or bounding box.",
"operationId": "GetCopyrightForWorld",
"x-ms-examples": {
- "GetCopyrightForWorld": {
- "$ref": "./examples/GetCopyrightForWorld.json"
+ "Successful World Copyright Request": {
+ "$ref": "./examples/SuccessfulWorldCopyrightRequest.json"
}
},
"parameters": [
@@ -760,14 +744,14 @@
"$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
},
{
- "$ref": "#/parameters/IncludeText"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/IncludeText"
}
],
"responses": {
"200": {
"description": "OK",
"schema": {
- "$ref": "#/definitions/GetCopyrightForWorldResult"
+ "$ref": "#/definitions/Copyright"
}
},
"default": {
@@ -778,34 +762,6 @@
}
},
"definitions": {
- "GetCopyrightFromBoundingBoxResult": {
- "description": "This object is returned from a successful Get Copyright From Bounding Box call",
- "type": "object",
- "properties": {
- "formatVersion": {
- "description": "Format Version property",
- "type": "string",
- "readOnly": true
- },
- "generalCopyrights": {
- "description": "General Copyrights array",
- "type": "array",
- "readOnly": true,
- "items": {
- "type": "string",
- "readOnly": true
- }
- },
- "regions": {
- "description": "Regions array",
- "type": "array",
- "readOnly": true,
- "items": {
- "$ref": "#/definitions/RegionCopyrights"
- }
- }
- }
- },
"RegionCopyrights": {
"type": "object",
"properties": {
@@ -837,8 +793,8 @@
}
}
},
- "GetCopyrightCaptionResult": {
- "description": "This object is returned from a successful Get Copyright Caption call",
+ "CopyrightCaption": {
+ "description": "This object is returned from a successful copyright call",
"type": "object",
"properties": {
"formatVersion": {
@@ -853,36 +809,8 @@
}
}
},
- "GetCopyrightForWorldResult": {
- "description": "This object is returned from a successful Get Copyright For World call",
- "type": "object",
- "properties": {
- "formatVersion": {
- "description": "Format Version property",
- "type": "string",
- "readOnly": true
- },
- "generalCopyrights": {
- "description": "General Copyrights array",
- "type": "array",
- "readOnly": true,
- "items": {
- "type": "string",
- "readOnly": true
- }
- },
- "regions": {
- "description": "Regions array",
- "type": "array",
- "readOnly": true,
- "items": {
- "$ref": "#/definitions/RegionCopyrights"
- }
- }
- }
- },
- "GetCopyrightForTileResult": {
- "description": "This object is returned from a successful Get Copyright For Tile call",
+ "Copyright": {
+ "description": "This object is returned from a successful copyright request",
"type": "object",
"properties": {
"formatVersion": {
diff --git a/specification/maps/data-plane/Render/preview/2.0/examples/GetMapTileV2.json b/specification/maps/data-plane/Render/preview/2.0/examples/SuccessfulTileRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/2.0/examples/GetMapTileV2.json
rename to specification/maps/data-plane/Render/preview/2.0/examples/SuccessfulTileRequest.json
diff --git a/specification/maps/data-plane/Render/preview/2.0/render.json b/specification/maps/data-plane/Render/preview/2.0/render.json
index 0435165eea1b..0c071a2d2683 100644
--- a/specification/maps/data-plane/Render/preview/2.0/render.json
+++ b/specification/maps/data-plane/Render/preview/2.0/render.json
@@ -65,12 +65,23 @@
"microsoft.base.road",
"microsoft.base.darkgrey",
"microsoft.base.labels.road",
+ "microsoft.base.labels.darkgrey",
"microsoft.base.hybrid.road",
+ "microsoft.base.hybrid.darkgrey",
"microsoft.imagery",
"microsoft.weather.radar.main",
"microsoft.weather.infrared.main",
"microsoft.dem",
- "microsoft.dem.contours"
+ "microsoft.dem.contours",
+ "microsoft.traffic.absolute",
+ "microsoft.traffic.absolute.main",
+ "microsoft.traffic.relative",
+ "microsoft.traffic.relative.main",
+ "microsoft.traffic.relative.dark",
+ "microsoft.traffic.delay",
+ "microsoft.traffic.delay.main",
+ "microsoft.traffic.reduced.main",
+ "microsoft.traffic.incident"
],
"x-ms-enum": {
"name": "TilesetID",
@@ -104,10 +115,18 @@
"value": "microsoft.base.labels.road",
"description": "Label data in our main style.
\n\nSupports zoom levels 0 through 22. Format: raster (png)."
},
+ {
+ "value": "microsoft.base.labels.darkgrey",
+ "description": "Label data in our dark grey style.
\n\nSupports zoom levels 0 through 22. Format: raster (png)."
+ },
{
"value": "microsoft.base.hybrid.road",
"description": "Road, boundary and label data in our main style.
\n\nSupports zoom levels 0 through 22. Format: raster (png)."
},
+ {
+ "value": "microsoft.base.hybrid.darkgrey",
+ "description": "Road, boundary and label data in our dark grey style.
\n\nSupports zoom levels 0 through 22. Format: raster (png)."
+ },
{
"value": "microsoft.imagery",
"description": "A combination of satellite and aerial imagery. Only available in S1 pricing SKU.
\n\nSupports zoom levels 1 through 19. Format: raster (jpeg)."
@@ -127,19 +146,46 @@
{
"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.
\n* The vertical unit for measurement of elevation height is meters.
\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).
\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).
\n\nSupports zoom levels 9 through 14. Format: vector (pbf)."
+ },
+ {
+ "value": "microsoft.traffic.absolute",
+ "description": "absolute traffic tiles in vector"
+ },
+ {
+ "value": "microsoft.traffic.absolute.main",
+ "description": "absolute traffic tiles in raster in our main style."
+ },
+ {
+ "value": "microsoft.traffic.relative",
+ "description": "relative traffic tiles in vector"
+ },
+ {
+ "value": "microsoft.traffic.relative.main",
+ "description": "relative traffic tiles in raster in our main style."
+ },
+ {
+ "value": "microsoft.traffic.relative.dark",
+ "description": "relative traffic tiles in raster in our dark style."
+ },
+ {
+ "value": "microsoft.traffic.delay",
+ "description": "traffic tiles in vector"
+ },
+ {
+ "value": "microsoft.traffic.delay.main",
+ "description": "traffic tiles in raster in our main style"
+ },
+ {
+ "value": "microsoft.traffic.reduced.main",
+ "description": "reduced traffic tiles in raster in our main style"
+ },
+ {
+ "value": "microsoft.traffic.incident",
+ "description": "incident tiles in vector"
}
]
},
"x-ms-parameter-location": "method"
- },
- "MapTileV2Zoom": {
- "name": "zoom",
- "in": "query",
- "description": "Zoom level for the desired tile. Please find TilesetID list below for more details on supported zoom level for each tilesetId.
\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.",
- "required": true,
- "type": "integer",
- "format": "int32",
- "x-ms-parameter-location": "method"
}
},
"paths": {
@@ -148,8 +194,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\nThe Get Map Tiles API allows users to request map tiles in vector or raster formats typically to be integrated into a map control or SDK. Some example tiles that can be requested are Azure Maps road tiles, real-time Weather Radar tiles or the map tiles created using [Azure Maps Creator](https://aka.ms/amcreator). By default, Azure Maps uses vector tiles for its web map control (Web SDK) and Android SDK.",
"operationId": "GetMapTileV2",
"x-ms-examples": {
- "GetMapTile": {
- "$ref": "./examples/GetMapTileV2.json"
+ "Successful Tile Request": {
+ "$ref": "./examples/SuccessfulTileRequest.json"
}
},
"parameters": [
@@ -163,7 +209,7 @@
"$ref": "#/parameters/TilesetId_rv2"
},
{
- "$ref": "#/parameters/MapTileV2Zoom"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
@@ -179,28 +225,7 @@
"format": "date-time"
},
{
- "name": "tileSize",
- "in": "query",
- "description": "The size of the returned map tile in pixels.",
- "type": "string",
- "enum": [
- "256",
- "512"
- ],
- "x-ms-enum": {
- "name": "TileSize",
- "modelAsString": true,
- "values": [
- {
- "value": "256",
- "description": "Return a 256 by 256 pixel tile. Available for all tilesetIds except for\n* microsoft.terra.main"
- },
- {
- "value": "512",
- "description": "Return a 512 by 512 pixel tile. Available for all tilesetIds except for \n* microsoft.weather.radar.main\n* microsoft.weather.infrared.main\n* microsoft.base.hybrid\n* microsoft.dem\n* microsoft.imagery"
- }
- ]
- }
+ "$ref": "../1.0/render.json#/parameters/MapTileSize"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
@@ -220,9 +245,7 @@
"200": {
"description": "The tile returned from a successful API call.",
"schema": {
- "type": "object",
- "format": "file",
- "readOnly": true
+ "$ref": "#/definitions/MapTile"
},
"headers": {
"Content-Type": {
@@ -237,5 +260,13 @@
}
}
}
+ },
+ "definitions": {
+ "MapTile": {
+ "description": "The tile returned from a successful API call.",
+ "type": "object",
+ "format": "file",
+ "readOnly": true
+ }
}
}
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/GetMapAttributionV2.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulAttributionRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/2.1/examples/GetMapAttributionV2.json
rename to specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulAttributionRequest.json
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulBoundingBoxCopyrightRequest.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulBoundingBoxCopyrightRequest.json
new file mode 100644
index 000000000000..8bd58db3b8e3
--- /dev/null
+++ b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulBoundingBoxCopyrightRequest.json
@@ -0,0 +1,33 @@
+{
+ "parameters": {
+ "api-version": "1.0",
+ "format": "json",
+ "mincoordinates": "52.41064,4.84228",
+ "maxcoordinates": "52.41072,4.84239",
+ "text": "yes"
+ },
+ "responses": {
+ "200": {
+ "headers": {},
+ "body": {
+ "formatVersion": "0.0.1",
+ "generalCopyrights": [
+ "© 1992 – 2016 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.",
+ "Data Source © 2016 TomTom",
+ "based on"
+ ],
+ "regions": [
+ {
+ "copyrights": [
+ "Topografische onderground Copyright © dienst voor het kadaster en de openbare registers, Apeldoorn 2016."
+ ],
+ "country": {
+ "ISO3": "NLD",
+ "label": "Netherlands"
+ }
+ }
+ ]
+ }
+ }
+ }
+}
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulCopyrightCaptionRequest.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulCopyrightCaptionRequest.json
new file mode 100644
index 000000000000..fa4e4cb47cd9
--- /dev/null
+++ b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulCopyrightCaptionRequest.json
@@ -0,0 +1,14 @@
+{
+ "parameters": {
+ "api-version": "1.0",
+ "format": "json"
+ },
+ "responses": {
+ "200": {
+ "body": {
+ "formatVersion": "0.0.1",
+ "copyrightsCaption": "© 1992 - 2017 TomTom."
+ }
+ }
+ }
+}
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulStateTileRequest.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulStateTileRequest.json
new file mode 100644
index 000000000000..d3119378b2e4
--- /dev/null
+++ b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulStateTileRequest.json
@@ -0,0 +1,17 @@
+{
+ "parameters": {
+ "api-version": "1.0",
+ "statesetId": "[statesetId]",
+ "zoom": 6,
+ "x": 10,
+ "y": 22
+ },
+ "responses": {
+ "200": {
+ "headers": {
+ "Content-Type": "application/vnd.mapbox-vector-tile"
+ },
+ "body": "{file}"
+ }
+ }
+}
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulStaticImageRequest.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulStaticImageRequest.json
new file mode 100644
index 000000000000..c747d41a9d99
--- /dev/null
+++ b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulStaticImageRequest.json
@@ -0,0 +1,18 @@
+{
+ "parameters": {
+ "api-version": "1.0",
+ "format": "png",
+ "zoom": 2,
+ "bbox": "1.355233,42.982261,24.980233,56.526017",
+ "layer": "basic",
+ "style": "main"
+ },
+ "responses": {
+ "200": {
+ "headers": {
+ "Content-Type": "image/png"
+ },
+ "body": "{file}"
+ }
+ }
+}
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTileCopyrightRequest.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTileCopyrightRequest.json
new file mode 100644
index 000000000000..6f1a8fb24822
--- /dev/null
+++ b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTileCopyrightRequest.json
@@ -0,0 +1,79 @@
+{
+ "parameters": {
+ "api-version": "1.0",
+ "format": "json",
+ "zoom": 6,
+ "x": 9,
+ "y": 22
+ },
+ "responses": {
+ "200": {
+ "body": {
+ "formatVersion": "0.0.1",
+ "generalCopyrights": [
+ "© 1992 - 2018 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.",
+ "Data Source © 2018 TomTom",
+ "based on"
+ ],
+ "regions": [
+ {
+ "copyrights": [
+ "© 2006 – 2018 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection and other intellectual property rights owned or licensed to TomTom. The product includes information copied with permission from Canadian authorities, including © Canada Post Corporation and Department of Natural Resources Canada, All rights reserved. The use of this material is subject to the terms of a License Agreement. You will be held liable for any unauthorized copying or disclosure of this material. Adapted from Statistics Canada: Boundary Files, 2016 Census; Road Network File, 2016; and Census Population and Dwelling Count Highlight Tables, 2016 Census. This does not constitute an endorsement by Statistics Canada of this product",
+ "The following copyright notice applies to the use of Administrative Area: © 2006 – 2018 TomTom. All rights reserved. Adapted from Statistics Canada: Boundary Files, 2016 Census: Census Population and Dwelling Count Highlight Tables, 2016. This does not constitute an endorsement by Statistics Canada of this product.",
+ "The following copyright notice applies to the use of Post- FSA layer and 6-digit layer: © 2006 – 2018 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection and other intellectual property rights owned or licensed to TomTom. The product includes information copied with permission from Canadian authorities, including © Canada Post Corporation, All rights reserved. The use of this material is subject to the terms of a License Agreement. You will be held liable for any unauthorized copying or disclosure of this material",
+ "The following copyright notice applies to the use of Points of Interest: © 2006 – 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze",
+ "The following copyright notice applies to the use of Telecommunications: © 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.",
+ "The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. © 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.",
+ "This product contains address point data made available under the city of Vancouver’s Open Data framework as documented on August 6, 2012 in: vancouver.ca/open-government-licence Contains public sector Datasets made available under the City of Toronto's Open Data Licence v2.0. This is specified in their terms available here: http://www1.toronto.ca/wps/portal/contentonly?vgnextoid=4a37e03bb8d1e310VgnVCM10000071d60f89RCRD",
+ "Contains information licensed under the Open Government Licence – Strathcona County. For specifics, please reference: https://data.strathcona.ca/licence",
+ "Contains information licensed under the Open Government Licence – County of Grande Prairie. For specifics, please reference: http://www.countygp.ab.ca/EN/main/community/maps-gis/open-data/open-data-licence.html",
+ "Contains information licensed under the Open Government Licence – Canada. For specifics, please reference: http://open.canada.ca/en/open-government-licence-canada",
+ "Contains information licensed under the Calgary Regional Partnership Open Data Licence. For specifics, please reference: http://calgaryregion.ca/dam/Website/reports/General/GIS/Public-documents/Calgary-Regional-Partnership-Open-Data-Licence/Calgary%20Regional%20Partnership%20Open%20Data%20Licence.pdf Contains information licensed under the Open Government Licence – Banff. For specifics, please reference: http://www.banffopendata.ca/Home/About",
+ "Contains information licensed under the Open Data License – City of Grande Prairie. For specifics, please reference: http://www.cityofgp.com/index.aspx?page=2332",
+ "Contains information licensed under the Open Government Licence – City of Victoria. For specifics, please reference: http://www.victoria.ca/EN/main/city/open-data-catalogue/open-data-licence.html",
+ "Contains information licenced under the Open Government Licence - Halifax. For specifics, please reference: http://www.halifax.ca/opendata/OD_TermsOfUse.php",
+ "Contains information provided by the City of Guelph under an open government license. For specifics, please reference: http://data.open.guelph.ca/pages/open-government-licence",
+ "Contains information licensed under the Open Government Licence – Haldimand County. For specifics, please reference: http://opendata.haldimandcounty.on.ca/",
+ "Contains information provided by the City of Hamilton under an open government license. For specifics, please reference: http://www2.hamilton.ca/NR/rdonlyres/C58984A4-FE11-40B9-A231-8572EB922AAA/0/OpenDataTermsAndConditions_Final.html Contains information licensed under the Open Government Licence - Niagara Region. For specifics, please reference: http://www.niagararegion.ca/government/opendata/terms-of-use.aspx",
+ "Contains information licensed under the Open Government Licence — Town of Oakville. For specifics, please reference: http://www.oakville.ca/data/open_data_licence.html",
+ "Contains information licensed under the Open Government Licence - The Corporation of the City of Windsor. For specifics, please reference: http://www.citywindsor.ca/opendata/Documents/OpenDataTermsofUse.pdf",
+ "Contains information licensed under the Open Government Licence – City of Regina. For specifics, please reference: https://www.regina.ca/residents/open-government/open-government-licence/",
+ "Contains information licensed under the Open Government License - British Columbia. Contains information licensed under the Open Government License - City of Surrey. Contains public sector datasets made available under the City of Brandon's Open Data License. For specifics, please reference: http://opengov.brandon.ca/terms.aspx",
+ "Contains information licensed under the Open Government License - Winnipeg. For specifics, please reference: https://data.winnipeg.ca/open-data-licence",
+ "Contains information licensed under the GeoNB Open Data Licence. For specifics, please reference: http://geonb.snb.ca/documents/license/geonb-odl_en.pdf",
+ "Contains information licensed under the Open Government Licence - The Corporation of the Municipality of Chatham-Kent. Contains information licensed under the Open Government Licence - Niagara Region. For specifics, please referec: https://niagaraopendata.ca/pages/open-government-license-2-0-niagara-region",
+ "Contains information licensed under the Open Government Licence - City of Welland. Contains information licensed under the Open Government Licence - Prince Edward Island. For specifics, please reference: https://www.princeedwardisland.ca/en/information/finance/open-government-licence-prince-edward-island",
+ "Contains information licensed under the Open Government License - Kamloops. For specifics, please reference: http://www.kamloops.ca/maps/disclaimer.html",
+ "Contains information licensed under the Open Government License - Nanaimo. For specifics, please reference: http://www.nanaimo.ca/EN/main/departments/information-technology/DataCatalogue/Licence.html Contains information licensed under the Open Government License – City of New Westminster. For specifics, please reference: http://opendata.newwestcity.ca/licence",
+ "Contains information licensed under the Open Government License – City of Prince George. For specifics, please reference: http://pgmap.princegeorge.ca/opendata/CityofPrinceGeorge_Open_Government_License_Open_Data.pdf",
+ "Contains Information licensed under the Open Government Licence – Brantford. For specifics, please reference: http://www.brantford.ca/govt/projects/opendata/Pages/OpenDataLicence.aspx",
+ "Contains data for Gatineau, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Laval, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Longueuil, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Montreal, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Rimouski, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode"
+ ],
+ "country": {
+ "ISO3": "CAN",
+ "label": "Canada"
+ }
+ },
+ {
+ "copyrights": [
+ "The following copyright notice applies to the use of Points of Interest: © 2006 – 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze",
+ "The following copyright notice applies to the use of Telecommunications: © 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.",
+ "The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. © 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.",
+ "© United States Postal Service 2017",
+ "Contains data made available by the Rhode Island Geographic Information System (RIGIS) consortium, the State of Rhode Island, and the University of Rhode Island. For specifics, please reference: http://www.rigis.org/information",
+ "Contains Address Points data made available by State of Maryland and MD iMAP. For specifics, please reference: http://imap.maryland.gov."
+ ],
+ "country": {
+ "ISO3": "USA",
+ "label": "United States"
+ }
+ }
+ ]
+ }
+ }
+ }
+}
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/GetMapTileV2.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTileRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/2.1/examples/GetMapTileV2.json
rename to specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTileRequest.json
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/GetMapTilesetV2.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTilesetRequest.json
similarity index 100%
rename from specification/maps/data-plane/Render/preview/2.1/examples/GetMapTilesetV2.json
rename to specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulTilesetRequest.json
diff --git a/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulWorldCopyrightRequest.json b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulWorldCopyrightRequest.json
new file mode 100644
index 000000000000..fee7389f1757
--- /dev/null
+++ b/specification/maps/data-plane/Render/preview/2.1/examples/SuccessfulWorldCopyrightRequest.json
@@ -0,0 +1,338 @@
+{
+ "parameters": {
+ "api-version": "1.0",
+ "format": "json"
+ },
+ "responses": {
+ "200": {
+ "body": {
+ "formatVersion": "0.0.1",
+ "generalCopyrights": [
+ "© 1992 - 2018 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.",
+ "Data Source © 2018 TomTom",
+ "based on"
+ ],
+ "regions": [
+ {
+ "copyrights": [
+ "This product contains cartographic information (geometry, street names, traffic flow, address points) made available by Govern d’Andorra under legal terms available here; https://www.govern.ad/avis-legal"
+ ],
+ "country": {
+ "ISO3": "AND",
+ "label": "Andorra"
+ }
+ },
+ {
+ "copyrights": [
+ "In New South Wales this product contains road centerline geometry from NSW Land Property Information licensed under CC-BY 3.0 AU. © Land and Property Information [2015]. Further information available here: http://spatialservices.finance.nsw.gov.au/mapping_and_imagery/lpi_web_services",
+ "In Queensland this product contains road centerline geometry from QLD Transport and Main Roads authority made available by the Queensland open data portal and licensed under CC-BY 3.0 AU. Further information available here: https://data.qld.gov.au/dataset/state-controlled-roads-queensland",
+ "In South Australia this product contains road centerline geometry from SA Department of Planning Transport and Infrastructure made available by the South Australian government and licensed under CC-BY 4.0. Further information available here: http://data.sa.gov.au/data/organization/department-of-planning-transport-and-infrastructure https://data.sa.gov.au/copyright",
+ "In Tasmania this product contains road centerline attribution from the Tasmanian Government Transport agency. http://www.transport.tas.gov.au/roadsafety/speed",
+ "In Victoria this product contains cartographic information (roads, speed restriction, vehicle restrictions) made available by the Victorian Government open data portal licensed under CC-BY 4.0. Further information here: http://vicroadsopendata.vicroadsmaps.opendata.arcgis.com/ https://www.data.vic.gov.au/data/dataset",
+ "In Western Australia this product contains medium scale road centerline geometry from Landgate made available by the Western Australian Government via their open that portal licensed under CC-BY 4.0 http://catalogue.beta.data.wa.gov.au/dataset/roads-lgate-012 http://opendefinition.org/od/2.0/en/",
+ "This product contains address point data made available in the PSMA Geocoded National Address File (G- NAF) offered via the Australian Federal Government open data portal under EULA terms based on Creative Commons license CC BY 4.0 with the following special restriction. For Specifics please reference: https://data.gov.au/dataset/geocoded-national-address-file-g-naf/resource/09f74802-08b1-4214-a6ea-3591b2753d30"
+ ],
+ "country": {
+ "ISO3": "AUS",
+ "label": "Australia"
+ }
+ },
+ {
+ "copyrights": [
+ "© BEV, GZ 1368/2017"
+ ],
+ "country": {
+ "ISO3": "AUT",
+ "label": "Austria"
+ }
+ },
+ {
+ "copyrights": [
+ "© Source data. State committee on property of the Republic of Belarus, 2015 © Republic unitary organization <>, 2016"
+ ],
+ "country": {
+ "ISO3": "BLR",
+ "label": "Belarus"
+ }
+ },
+ {
+ "copyrights": [
+ "© 2006 – 2018 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection and other intellectual property rights owned or licensed to TomTom. The product includes information copied with permission from Canadian authorities, including © Canada Post Corporation and Department of Natural Resources Canada, All rights reserved. The use of this material is subject to the terms of a License Agreement. You will be held liable for any unauthorized copying or disclosure of this material. Adapted from Statistics Canada: Boundary Files, 2016 Census; Road Network File, 2016; and Census Population and Dwelling Count Highlight Tables, 2016 Census. This does not constitute an endorsement by Statistics Canada of this product",
+ "The following copyright notice applies to the use of Administrative Area: © 2006 – 2018 TomTom. All rights reserved. Adapted from Statistics Canada: Boundary Files, 2016 Census: Census Population and Dwelling Count Highlight Tables, 2016. This does not constitute an endorsement by Statistics Canada of this product.",
+ "The following copyright notice applies to the use of Post- FSA layer and 6-digit layer: © 2006 – 2018 TomTom. All rights reserved. This material is proprietary and the subject of copyright protection and other intellectual property rights owned or licensed to TomTom. The product includes information copied with permission from Canadian authorities, including © Canada Post Corporation, All rights reserved. The use of this material is subject to the terms of a License Agreement. You will be held liable for any unauthorized copying or disclosure of this material",
+ "The following copyright notice applies to the use of Points of Interest: © 2006 – 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze",
+ "The following copyright notice applies to the use of Telecommunications: © 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.",
+ "The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. © 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.",
+ "This product contains address point data made available under the city of Vancouver’s Open Data framework as documented on August 6, 2012 in: vancouver.ca/open-government-licence Contains public sector Datasets made available under the City of Toronto's Open Data Licence v2.0. This is specified in their terms available here: http://www1.toronto.ca/wps/portal/contentonly?vgnextoid=4a37e03bb8d1e310VgnVCM10000071d60f89RCRD",
+ "Contains information licensed under the Open Government Licence – Strathcona County. For specifics, please reference: https://data.strathcona.ca/licence",
+ "Contains information licensed under the Open Government Licence – County of Grande Prairie. For specifics, please reference: http://www.countygp.ab.ca/EN/main/community/maps-gis/open-data/open-data-licence.html",
+ "Contains information licensed under the Open Government Licence – Canada. For specifics, please reference: http://open.canada.ca/en/open-government-licence-canada",
+ "Contains information licensed under the Calgary Regional Partnership Open Data Licence. For specifics, please reference: http://calgaryregion.ca/dam/Website/reports/General/GIS/Public-documents/Calgary-Regional-Partnership-Open-Data-Licence/Calgary%20Regional%20Partnership%20Open%20Data%20Licence.pdf Contains information licensed under the Open Government Licence – Banff. For specifics, please reference: http://www.banffopendata.ca/Home/About",
+ "Contains information licensed under the Open Data License – City of Grande Prairie. For specifics, please reference: http://www.cityofgp.com/index.aspx?page=2332",
+ "Contains information licensed under the Open Government Licence – City of Victoria. For specifics, please reference: http://www.victoria.ca/EN/main/city/open-data-catalogue/open-data-licence.html",
+ "Contains information licenced under the Open Government Licence - Halifax. For specifics, please reference: http://www.halifax.ca/opendata/OD_TermsOfUse.php",
+ "Contains information provided by the City of Guelph under an open government license. For specifics, please reference: http://data.open.guelph.ca/pages/open-government-licence",
+ "Contains information licensed under the Open Government Licence – Haldimand County. For specifics, please reference: http://opendata.haldimandcounty.on.ca/",
+ "Contains information provided by the City of Hamilton under an open government license. For specifics, please reference: http://www2.hamilton.ca/NR/rdonlyres/C58984A4-FE11-40B9-A231-8572EB922AAA/0/OpenDataTermsAndConditions_Final.html Contains information licensed under the Open Government Licence - Niagara Region. For specifics, please reference: http://www.niagararegion.ca/government/opendata/terms-of-use.aspx",
+ "Contains information licensed under the Open Government Licence — Town of Oakville. For specifics, please reference: http://www.oakville.ca/data/open_data_licence.html",
+ "Contains information licensed under the Open Government Licence - The Corporation of the City of Windsor. For specifics, please reference: http://www.citywindsor.ca/opendata/Documents/OpenDataTermsofUse.pdf",
+ "Contains information licensed under the Open Government Licence – City of Regina. For specifics, please reference: https://www.regina.ca/residents/open-government/open-government-licence/",
+ "Contains information licensed under the Open Government License - British Columbia. Contains information licensed under the Open Government License - City of Surrey. Contains public sector datasets made available under the City of Brandon's Open Data License. For specifics, please reference: http://opengov.brandon.ca/terms.aspx",
+ "Contains information licensed under the Open Government License - Winnipeg. For specifics, please reference: https://data.winnipeg.ca/open-data-licence",
+ "Contains information licensed under the GeoNB Open Data Licence. For specifics, please reference: http://geonb.snb.ca/documents/license/geonb-odl_en.pdf",
+ "Contains information licensed under the Open Government Licence - The Corporation of the Municipality of Chatham-Kent. Contains information licensed under the Open Government Licence - Niagara Region. For specifics, please referec: https://niagaraopendata.ca/pages/open-government-license-2-0-niagara-region",
+ "Contains information licensed under the Open Government Licence - City of Welland. Contains information licensed under the Open Government Licence - Prince Edward Island. For specifics, please reference: https://www.princeedwardisland.ca/en/information/finance/open-government-licence-prince-edward-island",
+ "Contains information licensed under the Open Government License - Kamloops. For specifics, please reference: http://www.kamloops.ca/maps/disclaimer.html",
+ "Contains information licensed under the Open Government License - Nanaimo. For specifics, please reference: http://www.nanaimo.ca/EN/main/departments/information-technology/DataCatalogue/Licence.html Contains information licensed under the Open Government License – City of New Westminster. For specifics, please reference: http://opendata.newwestcity.ca/licence",
+ "Contains information licensed under the Open Government License – City of Prince George. For specifics, please reference: http://pgmap.princegeorge.ca/opendata/CityofPrinceGeorge_Open_Government_License_Open_Data.pdf",
+ "Contains Information licensed under the Open Government Licence – Brantford. For specifics, please reference: http://www.brantford.ca/govt/projects/opendata/Pages/OpenDataLicence.aspx",
+ "Contains data for Gatineau, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Laval, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Longueuil, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Montreal, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode",
+ "Contains data for Rimouski, QC made available through Creative Commons Attribution 4.0 International. For specifics, please reference: https://creativecommons.org/licenses/by/4.0/legalcode"
+ ],
+ "country": {
+ "ISO3": "CAN",
+ "label": "Canada"
+ }
+ },
+ {
+ "copyrights": [
+ "© Swisstopo"
+ ],
+ "country": {
+ "ISO3": "CHE",
+ "label": "Switzerland"
+ }
+ },
+ {
+ "copyrights": [
+ "GeoBasis-DE/Geobasis NRW 2017"
+ ],
+ "country": {
+ "ISO3": "DEU",
+ "label": "Germany"
+ }
+ },
+ {
+ "copyrights": [
+ "© DAV, violation of these copyrights shall cause legal proceedings"
+ ],
+ "country": {
+ "ISO3": "DNK",
+ "label": "Denmark"
+ }
+ },
+ {
+ "copyrights": [
+ "© 2013-2018 TomTom-Nomago"
+ ],
+ "country": {
+ "ISO3": "DZA",
+ "label": "Algeria"
+ }
+ },
+ {
+ "copyrights": [
+ "This product contains cartographic information (geometry, street names, traffic flow) made available by Ajuntament de Lleida under legal terms available here: http://www.paeria.es/cas/avisLegal.asp",
+ "This product contains cartographic information (geometry, street names, traffic flow) made available by Ayuntamiento de Logroño under legal terms available here: http://web.logro-o.org/giswebpgm/ayuda/condicionesuso.html",
+ "This product contains address point data made available under the Gobierno de Navarra and offered under Creative Commons- Attribution (CC-by 3.0) license in: http://idena.navarra.es/busquedas/catalog/descargas/descargas.page",
+ "This product contains address point data made available by la Comunidad de Madrid with the product NomeCalles offered by El Instituto de Estadística de la Comunidad de Madrid in: http://www.madrid.org/nomecalles/DescargaBDTCorte.icm",
+ "This product contains address point data made available by la Dirección General del Catastro del Ministerio de Economía y Hacienda in: https://www.sedecatastro.gob.es/OVCFrames.aspx?TIPO=TIT&a=masiv",
+ "This product contains cartographic information (geometry, street names, traffic flow, address points) made available by Ajuntament de El Prat de Llobregat under legal terms available here: http://www.elprat.cat/plantilles/pr_re_mactfill_1c_imfl/_uGU6aDOKh21PMmm2WqoT4ZOhxsiMHAS0S7PZC2PCFqo",
+ "This product contains cartographic information (geometry, street names, traffic flow, address points) made available by Ayuntamiento de Valencia under legal terms available here: http://www.valencia.es/ayuntamiento/DatosAbiertos.nsf/vDocumentosTituloAux/Condiciones%20de%20uso?opendocument&lang=1&nivel=5&seccion=1",
+ "This product contains cartographic information (geometry, street names, traffic flow, address points) made available by Ajuntament de Sant Feu de Llobregat under legal terms available here: https://www.santfeliu.cat/common/misc/widget_container.faces?xmid=11796",
+ "This product contains cartographic information (geometry, street names, traffic flow) made available by Ayuntamiento de Vitoria-Gasteiz under Creative Commons Reconocimiento 3.0 España available here: TT#0041606-16 http://creativecommons.org/licenses/by/3.0/es/legalcode.es"
+ ],
+ "country": {
+ "ISO3": "ESP",
+ "label": "Spain"
+ }
+ },
+ {
+ "copyrights": [
+ "(navigation devices only) Michelin data © Michelin 2017 The following copyright applies to the Advanced Navigable MAP, Address Points, 2D City Map and Buildings: Source: Direction générale des Finances Publiques – Cadastre; Updated 2017"
+ ],
+ "country": {
+ "ISO3": "FRA",
+ "label": "France"
+ }
+ },
+ {
+ "copyrights": [
+ "Ordnance Survey of Northern Ireland",
+ "Contains Ordnance Survey data © Crown copyright and database right 2017",
+ "Code-Point® Open data; Contains Royal Mail data © Royal Mail copyright and database right 2017 Contains National Statistics data © Crown copyright and database right 2017"
+ ],
+ "country": {
+ "ISO3": "GBR",
+ "label": "United Kingdom"
+ }
+ },
+ {
+ "copyrights": [
+ "© Base data Bakosurtanal"
+ ],
+ "country": {
+ "ISO3": "IDN",
+ "label": "Indonesia"
+ }
+ },
+ {
+ "copyrights": [
+ "This product contains cartographic information (street names, address points) made available by the Regione Lombardia and offered under Italian Open Data License (IODL 2.0) http://www.dati.gov.it/iodl/2.0/) available at the following address: http://www.geoportale.regione.lombardia.it/en/i.i.t.-della-lombardia",
+ "This product contains cartographic information from Comune di Milano 1)– Servizio Sit e Statistica made available at https://geoportale.comune.milano.it/sit/open-data/ under license Creative Commons Attribution (CC BY 2,5) 2) Web portal available at https://www.comune.milano.it/wps/portal/ist/it/vivicitta/verde/parchi Under license Creative Commons Attribution (CC BY 3.0) (http://www.comune.milano.it/wps/portal/ist/it/extra/others/footer/legal)",
+ "This product contains cartographic information (street names, address points) made available by Regione Emilia Romagna and offered under Creative Commons Attribution (CC BY 2.5) available at following address http://geoportale.regione.emilia-romagna.it/it/catalogo/dati-cartografici/cartografia-di-base/database-topografico-regionale/gestione-viabilita-indirizzi/toponimi-e-numeri-civici This product contains cartographic information (street names, address points) made available by Comune di Torino and offered under Italian Open Data License (IODL 2.0) available at following address http://aperto.comune.torino.it/?q=node/504",
+ "This product contains cartographic information (street names, address points) made available by Regione Veneto and offered offered under Italian Open Data License (IODL 2.0) available at following address http://dati.veneto.it/dataset",
+ "This product contains cartographic information (street names, address points) made available by Regione Toscana and offered offered under under Creative Commons Attribution (CC BY 2.5), according to the legislation available at http://www.regione.toscana.it/documents/10180/492172/Decreto-2014_02_25n663.pdf/162db905-95fd-4b5e-bc41-88a629b5a3e5 and Regolamento http://raccoltanormativa.consiglio.regione.toscana.it/articolo?urndoc=urn:nir:regione.toscana:regolamento.giunta:2007-02-09;6/R&pr=idx,0;artic,1;articparziale,0, data available at following address http://dati.toscana.it/dataset/grafo-civici",
+ "This product contains cartographic information (area info) made available by Comune di Roma at http://dati.comune.roma.it/cms/it/dettaglio_ambiente.page?contentId=DTS5931 under license Creative Commons Attribution (CC BY 4.0)",
+ "This product contains data (house numbers, geographical and statistical info on administrative areas) made available under the Istituto Nazionale di Statistica and offered under Creative Commons- Attribution (CC-by 3.0) license in: http://www.istat.it/it/archivio/678 and http://datiopen.istat.it/",
+ "This product contains address point data made available under the Comune di Verona in: http://www.comune.verona.it/nqcontent.cfm?a_id=37426",
+ "This product contains address point data made available under the Comune di Vicenza in: http://www.comune.vicenza.it/servizi/opendata.php/76184",
+ "This product contains address point data from Comune di Milano – Servizio Sit e Statistica This product contains address point data made available under the Provincia di Biella in: http://cartografia.provincia.biella.it/on-line/Home/Repertorio/Consultazione/articolo3000217.html",
+ "This product contains address point data made available by Comune di Torino and offered under Italian Open Data License (IODL 2.0) available at following address http://aperto.comune.torino.it/?q=node/504",
+ "This product contains address point data made available under the Comune di Firenze and offered under Creative Commons- Attribution (CC-by 3.0) license in: http://opendata.comune.fi.it/statistica_territorio/dataset_0040.html",
+ "This product contains address point data made available by Regione Emilia Romagna and offered under Creative Commons Attribution (CC BY 2.5) available at following address http://geoportale.regione.emilia-romagna.it/it/catalogo/dati-cartografici/cartografia-di-base/database-topografico-regionale/gestione-viabilita-indirizzi/toponimi-e-numeri-civici",
+ "This product contains address point data made available by Regione Toscana and offered under Creative Commons Attribution (CC BY 2.5), according to the legislation available at http://www.regione.toscana.it/documents/10180/492172/Decreto-2014_02_25n663.pdf/162db905-95fd-4b5e-bc41-88a629b5a3e5 and Regolamento http://raccoltanormativa.consiglio.regione.toscana.it/articolo?urndoc=urn:nir:regione.toscana:regolamento.giunta:2007-02-09;6/R&pr=idx,0;artic,1;articparziale,0, data available at following address http://dati.toscana.it/dataset/grafo-civici",
+ "This product contains address point data made available by Regione Veneto and offered offered under Italian Open Data License (IODL 2.0) available at following address http://dati.veneto.it/dataset",
+ "This product contains address point data made available by Regione Autonoma Friuli Venezia Giulia and offered under ITALIA OPEN DATA LICENSE V2.0 (IODL 2.0). Data are available at following address : http://www.regione.fvg.it/rafvg/cms/RAFVG/ambiente-territorio/conoscere-ambiente-territorio/",
+ "This product contains address point data made available by Regione Umbria and offered under CCBY License. Data are available at following address : http://www.umbriageo.regione.umbria.it/pagine/servizi-wms-attivi?permalink=servizi-wms-attivi&permalink=servizi-wms-attivi This product contains address point data made available by Regione Lombardia and offered under Italian Open Data License (IODL 2.0 http://www.dati.gov.it/iodl/2.0/) available at the following address: http://www.geoportale.regione.lombardia.it/en/i.i.t.-della-lombardia"
+ ],
+ "country": {
+ "ISO3": "ITA",
+ "label": "Italy"
+ }
+ },
+ {
+ "copyrights": [
+ "© Royal Jordanian Geographic center"
+ ],
+ "country": {
+ "ISO3": "JOR",
+ "label": "Jordan"
+ }
+ },
+ {
+ "copyrights": [
+ "© Shobunsha Publications, Inc. © Shobunsha"
+ ],
+ "country": {
+ "ISO3": "JPN",
+ "label": "Japan"
+ }
+ },
+ {
+ "copyrights": [
+ "Based upon electronic data © Mappers Co., Ltd. All rights reserved"
+ ],
+ "country": {
+ "ISO3": "KOR",
+ "label": "Republic of Korea"
+ }
+ },
+ {
+ "copyrights": [
+ "© FICHIER DE BASE DES ADRESSES GEOCODEES : ADM. DU CADASTRE ET DE LA TOPOGRAPHIE (2017) [© File taken from the database of geocoded addresses: Land Registry and Topography Administration (2017)]"
+ ],
+ "country": {
+ "ISO3": "LUX",
+ "label": "Luxembourg"
+ }
+ },
+ {
+ "copyrights": [
+ "Macao Special Administrative Region Government – Cartography and Cadastre Bureau",
+ "This product contains Road Geometry data made available by Macao Special Administrative Region Government – Cartography and Cadastre Bureau: http://www.dscc.gov.mo/ENG/copyright.html"
+ ],
+ "country": {
+ "ISO3": "MAC",
+ "label": "Macao"
+ }
+ },
+ {
+ "copyrights": [
+ "The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. © 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved."
+ ],
+ "country": {
+ "ISO3": "MEX",
+ "label": "Mexico"
+ }
+ },
+ {
+ "copyrights": [
+ "This product includes data from Mapping Unit, Malta Environment and Planning Authority and licensed on behalf of them or © Mapping Unit, Malta Environment and Planning Authority"
+ ],
+ "country": {
+ "ISO3": "MLT",
+ "label": "Malta"
+ }
+ },
+ {
+ "copyrights": [
+ "Topografische onderground Copyright © dienst voor het kadaster en de openbare registers, Apeldoorn 2017"
+ ],
+ "country": {
+ "ISO3": "NLD",
+ "label": "Netherlands"
+ }
+ },
+ {
+ "copyrights": [
+ "Contains data under the Norwegian licence for Open Government data (NLOD) distributed by Statens Vegvesen"
+ ],
+ "country": {
+ "ISO3": "NOR",
+ "label": "Norway"
+ }
+ },
+ {
+ "copyrights": [
+ "This product contains cartographic information (geometry, street names) made available by LINZ and sourced from the LINZ Data Service and licensed under the Creative Commons Attribution 3.0 New Zealand license",
+ "This product contains cartographic information (geometry) made with the help of Aerial Imagery made available by LINZ and sourced from the LINZ Data Service and licensed by various government agencies for re-use under the Creative Commons Attribution 3.0 New Zealand license",
+ "This product contains cartographic information (crash data) made available by New Zealand Transport Agency licensed under CC-BY 3.0 NZL. Further information here: http://www.nzta.govt.nz/resources/grouped-crash-sites",
+ "This product contains cartographic information (geometry, lane information, street names) made available by New Zealand Transport Agency on agreement on a case by case basis. Further information here: https://www.nzta.govt.nz/about-us/about-this-site#privacy https://www.nzta.govt.nz/projects/",
+ "This product contains address point data made available in the New Zealand Address Dataset which is sourced from New Zealand Post and Land Information New Zealand (LINZ). New Zealand Post copyright reserved. Data sourced from LINZ Data Service is subject to Creative Commons Attribution 3.0 New Zealand license"
+ ],
+ "country": {
+ "ISO3": "NZL",
+ "label": "New Zealand"
+ }
+ },
+ {
+ "copyrights": [
+ "This product contains postal code data of Poşta Română made available under Open Government License: http://data.gov.ro/base/images/logoinst/OGL-ROU-1.0.pdf http://data.gov.ro/dataset/coduri-postale-romania"
+ ],
+ "country": {
+ "ISO3": "ROU",
+ "label": "Romania"
+ }
+ },
+ {
+ "copyrights": [
+ "© ROSREESTR"
+ ],
+ "country": {
+ "ISO3": "RUS",
+ "label": "Russian Federation"
+ }
+ },
+ {
+ "copyrights": [
+ "The following copyright notice applies to the use of Points of Interest: © 2006 – 2018 TomTom. All rights reserved. Portions of the POI database contained in Points of Interest North America have been provided by Neustar Localeze",
+ "The following copyright notice applies to the use of Telecommunications: © 2017 Pitney Bowes. All rights reserved. In addition, for the following product layers Wire Center Boundaries, ILEC Boundaries, and Rate Center Boundaries, the following also applies: This product contains information and/or data of Telcordia Technologies, Inc. (Telcordia) licensed to be included herein.",
+ "The following copyright notice applies to the use of TomTom Traffic: Portions of the data have been provided by Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. © 2017. Total Traffic & Weather Network, a division of iHeartMedia + Entertainment, Inc. All rights reserved.",
+ "© United States Postal Service 2017",
+ "Contains data made available by the Rhode Island Geographic Information System (RIGIS) consortium, the State of Rhode Island, and the University of Rhode Island. For specifics, please reference: http://www.rigis.org/information",
+ "Contains Address Points data made available by State of Maryland and MD iMAP. For specifics, please reference: http://imap.maryland.gov."
+ ],
+ "country": {
+ "ISO3": "USA",
+ "label": "United States"
+ }
+ }
+ ]
+ }
+ }
+ }
+}
diff --git a/specification/maps/data-plane/Render/preview/2.1/render.json b/specification/maps/data-plane/Render/preview/2.1/render.json
index 4ba3549001c9..c235acde5bf6 100644
--- a/specification/maps/data-plane/Render/preview/2.1/render.json
+++ b/specification/maps/data-plane/Render/preview/2.1/render.json
@@ -58,8 +58,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\nThe Get Map Tiles API allows users to request map tiles in vector or raster formats typically to be integrated into a map control or SDK. Some example tiles that can be requested are Azure Maps road tiles, real-time Weather Radar tiles or the map tiles created using [Azure Maps Creator](https://aka.ms/amcreator). By default, Azure Maps uses vector tiles for its web map control (Web SDK) and Android SDK.",
"operationId": "GetMapTileV2",
"x-ms-examples": {
- "GetMapTile": {
- "$ref": "./examples/GetMapTileV2.json"
+ "Successful Tile Request": {
+ "$ref": "./examples/SuccessfulTileRequest.json"
}
},
"parameters": [
@@ -73,7 +73,7 @@
"$ref": "../2.0/render.json#/parameters/TilesetId_rv2"
},
{
- "$ref": "../2.0/render.json#/parameters/MapTileV2Zoom"
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
@@ -89,28 +89,7 @@
"type": "string"
},
{
- "name": "tileSize",
- "in": "query",
- "description": "The size of the returned map tile in pixels.",
- "type": "string",
- "enum": [
- "256",
- "512"
- ],
- "x-ms-enum": {
- "name": "TileSize",
- "modelAsString": true,
- "values": [
- {
- "value": "256",
- "description": "Return a 256 by 256 pixel tile. Available for all tilesetIds except for\n* microsoft.terra.main"
- },
- {
- "value": "512",
- "description": "Return a 512 by 512 pixel tile. Available for all tilesetIds except for \n* microsoft.weather.radar.main\n* microsoft.weather.infrared.main\n* microsoft.base.hybrid\n* microsoft.dem\n* microsoft.imagery"
- }
- ]
- }
+ "$ref": "../1.0/render.json#/parameters/MapTileSize"
},
{
"$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
@@ -130,9 +109,7 @@
"200": {
"description": "The tile returned from a successful API call.",
"schema": {
- "type": "object",
- "format": "file",
- "readOnly": true
+ "$ref": "../2.0/render.json#/definitions/MapTile"
},
"headers": {
"Content-Type": {
@@ -152,8 +129,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\nThe Get Map Tileset API allows users to request metadata for a tileset.",
"operationId": "GetMapTileset",
"x-ms-examples": {
- "GetMapTileset": {
- "$ref": "./examples/GetMapTilesetV2.json"
+ "Successful Tileset Request": {
+ "$ref": "./examples/SuccessfulTilesetRequest.json"
}
},
"parameters": [
@@ -174,7 +151,7 @@
"200": {
"description": "OK",
"schema": {
- "$ref": "#/definitions/MapTilesetResultV2"
+ "$ref": "#/definitions/MapTileset"
}
},
"default": {
@@ -188,8 +165,8 @@
"description": "**Applies to**: S0 and S1 pricing tiers.\n\nThe Get Map Attribution API allows users to request map copyright attribution information for a section of a tileset.",
"operationId": "GetMapAttribution",
"x-ms-examples": {
- "GetMapAttribution": {
- "$ref": "./examples/GetMapAttributionV2.json"
+ "Successful Attribution Request": {
+ "$ref": "./examples/SuccessfulAttributionRequest.json"
}
},
"parameters": [
@@ -203,7 +180,13 @@
"$ref": "../2.0/render.json#/parameters/TilesetId_rv2"
},
{
- "$ref": "../2.0/render.json#/parameters/MapTileV2Zoom"
+ "name": "zoom",
+ "in": "query",
+ "description": "Zoom level for the desired map attribution.",
+ "required": true,
+ "type": "integer",
+ "format": "int32",
+ "x-ms-parameter-location": "method"
},
{
"name": "bounds",
@@ -213,7 +196,8 @@
"type": "array",
"collectionFormat": "csv",
"items": {
- "type": "string"
+ "type": "number",
+ "format": "double"
}
}
],
@@ -224,7 +208,396 @@
"200": {
"description": "OK",
"schema": {
- "$ref": "#/definitions/MapAttributionResultV2"
+ "$ref": "#/definitions/MapAttribution"
+ }
+ },
+ "default": {
+ "$ref": "../../../Common/preview/1.0/common.json#/responses/default"
+ }
+ }
+ }
+ },
+ "/map/statetile": {
+ "get": {
+ "description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nFetches state tiles in vector format typically to be integrated into indoor maps module of map control or SDK. The map control will call this API after user turns on dynamic styling (see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid))",
+ "operationId": "GetMapStateTile",
+ "x-ms-examples": {
+ "Successful State Tile Request": {
+ "$ref": "./examples/SuccessfulStateTileRequest.json"
+ }
+ },
+ "parameters": [
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ClientId"
+ },
+ {
+ "$ref": "#/parameters/ApiVersion"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
+ },
+ {
+ "name": "statesetId",
+ "in": "query",
+ "description": "The stateset id.",
+ "required": true,
+ "type": "string"
+ }
+ ],
+ "produces": [
+ "application/vnd.mapbox-vector-tile",
+ "application/json"
+ ],
+ "responses": {
+ "200": {
+ "description": "This tile is returned from a successful Get Map State Tile call",
+ "schema": {
+ "$ref": "../2.0/render.json#/definitions/MapTile"
+ },
+ "headers": {
+ "Content-Type": {
+ "type": "string",
+ "description": "The content-type for the response."
+ }
+ }
+ },
+ "default": {
+ "$ref": "../../../Common/preview/1.0/common.json#/responses/default"
+ }
+ }
+ }
+ },
+ "/map/copyright/caption/{format}": {
+ "get": {
+ "description": "**Applies to**: S0 and S1 pricing tiers.\n\n\n\nCopyrights API is designed to serve copyright information for Render Tile \nservice. In addition to basic copyright for the whole map, API is serving \nspecific groups of copyrights for some countries.\n\nAs an alternative to copyrights for map request, one can receive captions\nfor displaying the map provider information on the map.",
+ "operationId": "GetCopyrightCaption",
+ "x-ms-examples": {
+ "Successful Copyright Caption Request": {
+ "$ref": "./examples/SuccessfulCopyrightCaptionRequest.json"
+ }
+ },
+ "parameters": [
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ClientId"
+ },
+ {
+ "$ref": "#/parameters/ApiVersion"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "../1.0/render.json#/definitions/CopyrightCaption"
+ }
+ },
+ "default": {
+ "$ref": "../../../Common/preview/1.0/common.json#/responses/default"
+ }
+ }
+ }
+ },
+ "/map/static/{format}": {
+ "get": {
+ "description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nThe static image service renders a user-defined, rectangular image containing a map section using a zoom level from 0 to 20. The static image service renders a user-defined, rectangular image containing a map section using a zoom level from 0 to 20. The supported resolution range for the map image is from 1x1 to 8192x8192. If you are deciding when to use the static image service over the map tile service, you may want to consider how you would like to interact with the rendered map. If the map contents will be relatively unchanging, a static map is a good choice. If you want to support a lot of zooming, panning and changing of the map content, the map tile service would be a better choice. \n\nService also provides Image Composition functionality to get a static image back with additional data like; pushpins and geometry overlays with following S0 and S1 capabilities. \n\nIn S0 you can:\n- Render up to 5 pushpins specified in the request\n- Provide one custom image for the pins referenced in the request\n- Add labels to the pushpins\n\nIn S1 you can:\n- Render pushpins through [Azure Maps Data Service](https://aka.ms/AzureMapsMapDataService)\n- Specify multiple pushpin styles\n- Render circle, polyline and polygon geometry types.\n- Render of supported GeoJSON geometry types uploaded through [Azure Maps Data Service](https://aka.ms/AzureMapsMapDataService)\n\nPlease see [How-to-Guide](https://aka.ms/AzureMapsHowToGuideImageCompositor) for detailed examples.\n\n_Note_ : Either **center** or **bbox** parameter must be supplied to the\nAPI.\n
\nThe supported Lat and Lon ranges when using the **bbox** parameter, are as follows:\n
\n\n |Zoom Level | Max Lon Range | Max Lat Range|\n |:----------|:----------------|:-------------|\n |0 | 360.0 | 170.0 | \n |1 | 360.0 | 170.0 |\n |2 | 360.0 | 170.0 |\n |3 | 360.0 | 170.0 |\n |4 | 360.0 | 170.0 |\n |5 | 180.0 | 85.0 |\n |6 | 90.0 | 42.5 |\n |7 | 45.0 | 21.25 |\n |8 | 22.5 | 10.625 |\n |9 | 11.25 | 5.3125 |\n |10 | 5.625 | 2.62625 |\n |11 | 2.8125 | 1.328125 |\n |12 | 1.40625 | 0.6640625 |\n |13 | 0.703125 | 0.33203125 |\n |14 | 0.3515625 | 0.166015625 |\n |15 | 0.17578125 | 0.0830078125 | \n |16 | 0.087890625 | 0.0415039063 | \n |17 | 0.0439453125 | 0.0207519531 |\n |18 | 0.0219726563 | 0.0103759766 |\n |19 | 0.0109863281 | 0.0051879883 |\n |20 | 0.0054931641 | 0.0025939941 |",
+ "operationId": "GetMapStaticImage",
+ "x-ms-examples": {
+ "Successful Static Image Request": {
+ "$ref": "./examples/SuccessfulStaticImageRequest.json"
+ }
+ },
+ "parameters": [
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ClientId"
+ },
+ {
+ "$ref": "#/parameters/ApiVersion"
+ },
+ {
+ "$ref": "../1.0/render.json#/parameters/RasterTileFormat"
+ },
+ {
+ "name": "layer",
+ "in": "query",
+ "description": "Map layer requested. If layer is set to labels or hybrid, the format should be png.",
+ "type": "string",
+ "enum": [
+ "basic",
+ "hybrid",
+ "labels"
+ ],
+ "x-ms-enum": {
+ "name": "StaticMapLayer",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "basic",
+ "description": "Returns an image containing all map features including polygons, borders, roads and labels."
+ },
+ {
+ "value": "hybrid",
+ "description": "Returns an image containing borders, roads, and labels, and can be overlaid on other tiles (such as satellite imagery) to produce hybrid tiles."
+ },
+ {
+ "value": "labels",
+ "description": "Returns an image of just the map's label information."
+ }
+ ]
+ }
+ },
+ {
+ "name": "style",
+ "in": "query",
+ "description": "Map style to be returned. Possible values are main and dark.",
+ "type": "string",
+ "enum": [
+ "main",
+ "dark"
+ ],
+ "x-ms-enum": {
+ "name": "MapImageStyle",
+ "modelAsString": true,
+ "values": [
+ {
+ "value": "main",
+ "description": "Azure Maps main style"
+ },
+ {
+ "value": "dark",
+ "description": "Dark grey version of the Azure Maps main style"
+ }
+ ]
+ }
+ },
+ {
+ "name": "zoom",
+ "in": "query",
+ "description": "Desired zoom level of the map. Zoom value must be in the range: 0-20 (inclusive). Default value is 12.
Please see [Zoom Levels and Tile Grid](https://docs.microsoft.com/en-us/azure/location-based-services/zoom-levels-and-tile-grid) for details.",
+ "type": "integer",
+ "format": "int32",
+ "minimum": 0,
+ "maximum": 20
+ },
+ {
+ "name": "center",
+ "in": "query",
+ "description": "Coordinates of the center point. Format: 'lon,lat'. Projection used\n- EPSG:3857. Longitude range: -180 to 180. Latitude range: -85 to 85. \n\nNote: Either center or bbox are required parameters. They are\nmutually exclusive.",
+ "type": "array",
+ "collectionFormat": "csv",
+ "items": {
+ "type": "number",
+ "format": "double"
+ }
+ },
+ {
+ "name": "bbox",
+ "x-ms-client-name": "boundingBox",
+ "in": "query",
+ "description": "Bounding box. Projection used - EPSG:3857. Format : 'minLon, minLat,\nmaxLon, maxLat'. \n\nNote: Either bbox or center are required\nparameters. They are mutually exclusive. It shouldn’t be used with\nheight or width.\n\nThe maximum allowed ranges for Lat and Lon are defined for each zoom level\nin the table at the top of this page.",
+ "type": "array",
+ "collectionFormat": "csv",
+ "items": {
+ "type": "number",
+ "format": "double"
+ }
+ },
+ {
+ "name": "height",
+ "in": "query",
+ "description": "Height of the resulting image in pixels. Range is 1 to 8192. Default\nis 512. It shouldn’t be used with bbox.",
+ "type": "integer",
+ "format": "int32",
+ "minimum": 1,
+ "maximum": 8192
+ },
+ {
+ "name": "width",
+ "in": "query",
+ "description": "Width of the resulting image in pixels. Range is 1 to 8192. Default is 512. It shouldn’t be used with bbox.",
+ "type": "integer",
+ "format": "int32",
+ "minimum": 1,
+ "maximum": 8192
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/Language"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/View"
+ },
+ {
+ "name": "pins",
+ "description": "Pushpin style and instances. Use this parameter to optionally add pushpins to the image.\nThe pushpin style describes the appearance of the pushpins, and the instances specify\nthe coordinates of the pushpins and optional labels for each pin. (Be sure to properly URL-encode values of this\nparameter since it will contain reserved characters such as pipes and punctuation.)\n\nThe Azure Maps account S0 SKU only supports a single instance of the pins parameter. Other SKUs\nallow multiple instances of the pins parameter to specify multiple pin styles.\n\nTo render a pushpin at latitude 45°N and longitude 122°W using the default built-in pushpin style, add the\nquerystring parameter \n\n`pins=default||-122 45` \n\nNote that the longitude comes before the latitude.\nAfter URL encoding this will look like\n\n`pins=default%7C%7C-122+45`\n\nAll of the examples here show the pins\nparameter without URL encoding, for clarity.\n\nTo render a pin at multiple locations, separate each location with a pipe character. For example, use\n\n`pins=default||-122 45|-119.5 43.2|-121.67 47.12`\n\nThe S0 Azure Maps account SKU only allows five pushpins. Other account SKUs do not have this limitation.\n\n### Style Modifiers\n\nYou can modify the appearance of the pins by adding style modifiers. These are added after the style but before\nthe locations and labels. Style modifiers each have a two-letter name. These abbreviated names are used to help\nreduce the length of the URL.\n\nTo change the color of the pushpin, use the 'co' style modifier and specify the color using the HTML/CSS RGB color\nformat which is a six-digit hexadecimal number (the three-digit form is not supported). For example, to use\na deep pink color which you would specify as #FF1493 in CSS, use\n\n`pins=default|coFF1493||-122 45`\n\n### Pushpin Labels\n\nTo add a label to the pins, put the label in single quotes just before the coordinates. For example, to label\nthree pins with the values '1', '2', and '3', use\n\n`pins=default||'1'-122 45|'2'-119.5 43.2|'3'-121.67 47.12`\n\nThere is a built in pushpin style called 'none' that does not display a pushpin image. You can use this if\nyou want to display labels without any pin image. For example,\n\n`pins=none||'A'-122 45|'B'-119.5 43.2`\n\nTo change the color of the pushpin labels, use the 'lc' label color style modifier. For example, to use pink\npushpins with black labels, use\n\n`pins=default|coFF1493|lc000000||-122 45`\n\nTo change the size of the labels, use the 'ls' label size style modifier. The label size represents the approximate\nheight of the label text in pixels. For example, to increase the label size to 12, use\n\n`pins=default|ls12||'A'-122 45|'B'-119 43`\n\nThe labels are centered at the pushpin 'label anchor.' The anchor location is predefined for built-in pushpins and\nis at the top center of custom pushpins (see below). To override the label anchor, using the 'la' style modifier\nand provide X and Y pixel coordinates for the anchor. These coordinates are relative to the top left corner of the\npushpin image. Positive X values move the anchor to the right, and positive Y values move the anchor down. For example,\nto position the label anchor 10 pixels right and 4 pixels above the top left corner of the pushpin image,\nuse\n\n`pins=default|la10 -4||'A'-122 45|'B'-119 43`\n\n### Custom Pushpins\n\nTo use a custom pushpin image, use the word 'custom' as the pin style name, and then specify a URL after the\nlocation and label information. Use two pipe characters to indicate that you're done specifying locations and are\nstarting the URL. For example,\n\n`pins=custom||-122 45||http://contoso.com/pushpins/red.png`\n\nAfter URL encoding, this would look like\n\n`pins=custom%7C%7C-122+45%7C%7Chttp%3A%2F%2Fcontoso.com%2Fpushpins%2Fred.png`\n\nBy default, custom pushpin images are drawn centered at the pin coordinates. This usually isn't ideal as it obscures\nthe location that you're trying to highlight. To override the anchor location of the pin image, use the 'an'\nstyle modifier. This uses the same format as the 'la' label anchor style modifier. For example, if your custom\npin image has the tip of the pin at the top left corner of the image, you can set the anchor to that spot by\nusing\n\n`pins=custom|an0 0||-122 45||http://contoso.com/pushpins/red.png`\n\nNote: If you use the 'co' color modifier with a custom pushpin image, the specified color will replace the RGB \nchannels of the pixels in the image but will leave the alpha (opacity) channel unchanged. This would usually\nonly be done with a solid-color custom image.\n\n### Getting Pushpins from Azure Maps Data Storage\n\nFor all Azure Maps account SKUs other than S0,\nthe pushpin location information can be obtained from Azure Maps Data Storage. After uploading a GeoJSON document containing pin locations, the Data Storage service returns a Unique Data ID (UDID) that you can use\nto reference the data in the pins parameter.\n\nTo use the point geometry from an uploaded GeoJSON document as the pin locations, specify the UDID in the locations\nsection of the pins parameter. For example,\n\n`pins=default||udid-29dc105a-dee7-409f-a3f9-22b066ae4713`\n\nNote that\nonly point and multipoint geometry, points and multipoints from geometry collections, and point geometry from features\nwill be used. Linestring and polygon geometry will be ignored. If the point comes from a feature and the feature\nhas a string property called \"label\", the value of that property will be used as the label for the pin.\n\nYou can mix pin locations from Data Storage and pin locations specified in the pins parameter. Any of the pipe-delimited\npin locations can be a longitude and latitude or a UDID. For example,\n\n`pins=default||-122 45|udid-29dc105a-dee7-409f-a3f9-22b066ae4713|-119 43`\n\n### Scale, Rotation, and Opacity\n\nYou can make pushpins and their labels larger or smaller by using the 'sc' scale style modifier. This is a\nvalue greater than zero. A value of 1 is the standard scale. Values larger than 1 will make the pins larger, and\nvalues smaller than 1 will make them smaller. For example, to draw the pushpins 50% larger than normal, use\n\n`pins=default|sc1.5||-122 45`\n\nYou can rotate pushpins and their labels by using the 'ro' rotation style modifier. This is a number of degrees\nof clockwise rotation. Use a negative number to rotate counter-clockwise. For example, to rotate the pushpins\n90 degrees clockwise and double their size, use\n\n`pins=default|ro90|sc2||-122 45`\n\nYou can make pushpins and their labels partially transparent by specifying the 'al' alpha style modifier.\nThis is a number between 0 and 1 indicating the opacity of the pushpins. Zero makes them completely transparent\n(and not visible) and 1 makes them completely opaque (which is the default). For example, to make pushpins\nand their labels only 67% opaque, use\n\n`pins=default|al.67||-122 45`\n\n### Style Modifier Summary\n\nModifier | Description | Range \n:--------:|-----------------|------------------\nal | Alpha (opacity) | 0 to 1 \nan | Pin anchor | * \nco | Pin color | 000000 to FFFFFF \nla | Label anchor | * \nlc | Label color | 000000 to FFFFFF \nls | Label size | Greater than 0 \nro | Rotation | -360 to 360 \nsc | Scale | Greater than 0 \n\n* X and Y coordinates can be anywhere within pin image or a margin around it.\nThe margin size is the minimum of the pin width and height.",
+ "in": "query",
+ "type": "array",
+ "collectionFormat": "multi",
+ "items": {
+ "type": "string"
+ }
+ },
+ {
+ "name": "path",
+ "description": "Path style and locations. Use this parameter to optionally add lines, polygons or circles to the image.\nThe path style describes the appearance of the line and fill. (Be sure to properly URL-encode values of this\nparameter since it will contain reserved characters such as pipes and punctuation.)\n\nPath parameter is supported in Azure Maps account SKU starting with S1. Multiple instances of the path parameter \nallow to specify multiple geometries with their styles. Number of parameters per request is limited to 10 and\nnumber of locations is limited to 100 per path.\n\nTo render a circle with radius 100 meters and center point at latitude 45°N and longitude 122°W using the default style, add the\nquerystring parameter \n\n`path=ra100||-122 45` \n\nNote that the longitude comes before the latitude.\nAfter URL encoding this will look like\n\n`path=ra100%7C%7C-122+45`\n\nAll of the examples here show the path parameter without URL encoding, for clarity.\n\nTo render a line, separate each location with a pipe character. For example, use\n\n`path=||-122 45|-119.5 43.2|-121.67 47.12`\n\nTo render a polygon, last location must be equal to the start location. For example, use\n\n`path=||-122 45|-119.5 43.2|-121.67 47.12|-122 45`\n\nLongitude and latitude values for locations of lines and polygons can be in the range from -360 to 360 to allow for rendering of geometries crossing the anti-meridian.\n\n### Style Modifiers\n\nYou can modify the appearance of the path by adding style modifiers. These are added before the locations. \nStyle modifiers each have a two-letter name. These abbreviated names are used to help reduce the length\nof the URL.\n\nTo change the color of the outline, use the 'lc' style modifier and specify the color using the HTML/CSS RGB color\nformat which is a six-digit hexadecimal number (the three-digit form is not supported). For example, to use\na deep pink color which you would specify as #FF1493 in CSS, use\n\n`path=lcFF1493||-122 45|-119.5 43.2`\n\nMultiple style modifiers may be combined together to create a more complex visual style.\n\n`lc0000FF|lw3|la0.60|fa0.50||-122.2 47.6|-122.2 47.7|-122.3 47.7|-122.3 47.6|-122.2 47.6`\n\n### Getting Path locations from Azure Maps Data Storage\n\nFor all Azure Maps account SKUs other than S0, the path location information can be obtained from Azure Maps Data Storage. \nAfter uploading a GeoJSON document containing path locations, the Data Storage service returns a Unique Data ID (UDID) that you can use\nto reference the data in the path parameter.\n\nTo use the point geometry from an uploaded GeoJSON document as the path locations, specify the UDID in the locations\nsection of the path parameter. For example,\n\n`path=||udid-29dc105a-dee7-409f-a3f9-22b066ae4713`\n\nNote the it is not allowed to mix path locations from Data Storage with locations specified in the path parameter. \n\n### Style Modifier Summary\n\nModifier | Description | Range \n:--------:|------------------------|------------------\nlc | Line color | 000000 to FFFFFF\nfc | Fill color | 000000 to FFFFFF\nla | Line alpha (opacity) | 0 to 1 \nfa | Fill alpha (opacity) | 0 to 1 \nlw | Line width | Greater than 0 \nra | Circle radius (meters) | Greater than 0",
+ "in": "query",
+ "type": "array",
+ "collectionFormat": "multi",
+ "items": {
+ "type": "string"
+ }
+ }
+ ],
+ "produces": [
+ "application/json",
+ "image/jpeg",
+ "image/png",
+ "image/pbf",
+ "application/vnd.mapbox-vector-tile"
+ ],
+ "responses": {
+ "200": {
+ "description": "This image is returned from a successful Get Map Static Image call",
+ "schema": {
+ "type": "object",
+ "format": "file",
+ "readOnly": true
+ },
+ "headers": {
+ "Content-Type": {
+ "type": "string",
+ "description": "The content-type for the response."
+ }
+ }
+ },
+ "default": {
+ "$ref": "../../../Common/preview/1.0/common.json#/responses/default"
+ }
+ }
+ }
+ },
+ "/map/copyright/bounding/{format}": {
+ "get": {
+ "description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nReturns copyright information for a given bounding box. Bounding-box requests should specify the minimum and maximum longitude and latitude (EPSG-3857) coordinates",
+ "operationId": "GetCopyrightFromBoundingBox",
+ "x-ms-examples": {
+ "SuccessfulBoundingBoxCopyrightRequest": {
+ "$ref": "./examples/SuccessfulBoundingBoxCopyrightRequest.json"
+ }
+ },
+ "parameters": [
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ClientId"
+ },
+ {
+ "$ref": "#/parameters/ApiVersion"
+ },
+ {
+ "$ref": "../1.0/render.json#/parameters/BoundingBoxSouthWest"
+ },
+ {
+ "$ref": "../1.0/render.json#/parameters/BoundingBoxNorthEast"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/IncludeText"
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "../1.0/render.json#/definitions/Copyright"
+ }
+ },
+ "default": {
+ "$ref": "../../../Common/preview/1.0/common.json#/responses/default"
+ }
+ }
+ }
+ },
+ "/map/copyright/tile/{format}": {
+ "get": {
+ "description": "**Applies to**: S0 and S1 pricing tiers.\n\n\n\nCopyrights API is designed to serve copyright information for Render Tile service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries.\nReturns the copyright information for a given tile. To obtain the copyright information for a particular tile, the request should specify the tile's zoom level and x and y coordinates (see: Zoom Levels and Tile Grid).",
+ "operationId": "GetCopyrightForTile",
+ "x-ms-examples": {
+ "Successful Tile Copyright Request": {
+ "$ref": "./examples/SuccessfulTileCopyrightRequest.json"
+ }
+ },
+ "parameters": [
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ClientId"
+ },
+ {
+ "$ref": "#/parameters/ApiVersion"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/zTileIndex"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/xTileIndex"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/yTileIndex"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/IncludeText"
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "../1.0/render.json#/definitions/Copyright"
+ }
+ },
+ "default": {
+ "$ref": "../../../Common/preview/1.0/common.json#/responses/default"
+ }
+ }
+ }
+ },
+ "/map/copyright/world/{format}": {
+ "get": {
+ "description": "**Applies to**: S0 and S1 pricing tiers.\n\n\nCopyrights API is designed to serve copyright information for Render Tile service. In addition to basic copyright for the whole map, API is serving specific groups of copyrights for some countries.\nReturns the copyright information for the world. To obtain the default copyright information for the whole world, do not specify a tile or bounding box.",
+ "operationId": "GetCopyrightForWorld",
+ "x-ms-examples": {
+ "Successful World Copyright Request": {
+ "$ref": "./examples/SuccessfulWorldCopyrightRequest.json"
+ }
+ },
+ "parameters": [
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ClientId"
+ },
+ {
+ "$ref": "#/parameters/ApiVersion"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/ResponseFormat"
+ },
+ {
+ "$ref": "../../../Common/preview/1.0/common.json#/parameters/IncludeText"
+ }
+ ],
+ "responses": {
+ "200": {
+ "description": "OK",
+ "schema": {
+ "$ref": "../1.0/render.json#/definitions/Copyright"
}
},
"default": {
@@ -235,13 +608,7 @@
}
},
"definitions": {
- "MapTileResultv2": {
- "description": "The tile returned from a successful API call.",
- "type": "object",
- "format": "file",
- "readOnly": true
- },
- "MapTilesetResultV2": {
+ "MapTileset": {
"description": "Metadata for a tileset in the TileJSON format.",
"type": "object",
"readOnly": true,
@@ -249,24 +616,24 @@
"tilejson": {
"type": "string",
"pattern": "\\d+\\.\\d+\\.\\d+\\w?[\\w\\d]*",
- "description": "Version of the TileJSON spec."
+ "description": "Describes the version of the TileJSON spec that is implemented by this JSON object."
},
"name": {
"type": "string",
- "description": "Name of the tileset."
+ "description": "A name describing the tileset. The name can contain any legal character. Implementations SHOULD NOT interpret the name as HTML."
},
"description": {
"type": "string",
- "description": "Text description of the tileset."
+ "description": "Text description of the tileset. The description can contain any legal character. Implementations SHOULD NOT interpret the description as HTML."
},
"version": {
"type": "string",
"pattern": "\\d+\\.\\d+\\.\\d+\\w?[\\w\\d]*",
- "description": "A semver.org style version number for the tiles contained within the tileset."
+ "description": "A semver.org style version number for the tiles contained within the tileset. When changes across tiles are introduced, the minor version MUST change."
},
"attribution": {
"type": "string",
- "description": "Copyright attribution to be displayed on the map."
+ "description": "Copyright attribution to be displayed on the map. Implementations MAY decide to treat this as HTML or literal text. For security reasons, make absolutely sure that this field can't be abused as a vector for XSS or beacon tracking."
},
"template": {
"type": "string",
@@ -274,18 +641,18 @@
},
"legend": {
"type": "string",
- "description": "A legend to be displayed with the map."
+ "description": "A legend to be displayed with the map. Implementations MAY decide to treat this as HTML or literal text. For security reasons, make absolutely sure that this field can't be abused as a vector for XSS or beacon tracking."
},
"scheme": {
"type": "string",
- "description": "Default: \"xyz\". Either \"xyz\" or \"tms\". Influences the y direction of the tile coordinates."
+ "description": "Default: \"xyz\". Either \"xyz\" or \"tms\". Influences the y direction of the tile coordinates. The global-mercator (aka Spherical Mercator) profile is assumed."
},
"tiles": {
"type": "array",
"items": {
"type": "string"
},
- "description": "An array of tile endpoints."
+ "description": "An array of tile endpoints. If multiple endpoints are specified, clients may use any combination of endpoints. All endpoints MUST return the same content for the same URL. The array MUST contain at least one endpoint."
},
"grids": {
"type": "array",
@@ -302,12 +669,14 @@
"description": "An array of data files in GeoJSON format."
},
"minzoom": {
+ "x-ms-client-name": "minZoom",
"minimum": 0,
"maximum": 30,
"type": "integer",
"description": "The minimum zoom level."
},
"maxzoom": {
+ "x-ms-client-name": "maxZoom",
"minimum": 0,
"maximum": 30,
"type": "integer",
@@ -318,18 +687,18 @@
"items": {
"type": "number"
},
- "description": "The WGS84 bounds of the tileset."
+ "description": "The maximum extent of available map tiles. Bounds MUST define an area covered by all zoom levels. The bounds are represented in WGS:84 latitude and longitude values, in the order left, bottom, right, top. Values may be integers or floating point numbers."
},
"center": {
"type": "array",
"items": {
"type": "number"
},
- "description": "The default location of the tileset in the form [longitude, latitude, zoom]."
+ "description": "The default location of the tileset in the form [longitude, latitude, zoom]. The zoom level MUST be between minzoom and maxzoom. Implementations can use this value to set the default location."
}
}
},
- "MapAttributionResultV2": {
+ "MapAttribution": {
"description": "Copyright attribution for the requested section of a tileset.",
"type": "object",
"readOnly": true,
diff --git a/specification/maps/data-plane/Render/readme.go.md b/specification/maps/data-plane/Render/readme.go.md
index 309634d3db6f..e5665e8bf508 100644
--- a/specification/maps/data-plane/Render/readme.go.md
+++ b/specification/maps/data-plane/Render/readme.go.md
@@ -13,7 +13,6 @@ export-clients: true
``` yaml $(go) && $(multiapi)
batch:
- - tag: 2.0-preview
- tag: 2.1-preview
```
diff --git a/specification/maps/data-plane/Render/readme.md b/specification/maps/data-plane/Render/readme.md
index 742c370a1a2b..252789e625af 100644
--- a/specification/maps/data-plane/Render/readme.md
+++ b/specification/maps/data-plane/Render/readme.md
@@ -40,7 +40,6 @@ These settings apply only when `--tag=2.1-preview` is specified on the command l
``` yaml $(tag) == '2.1-preview'
input-file:
- - preview/1.0/render.json
- preview/2.1/render.json
```
@@ -50,10 +49,18 @@ These settings apply only when `--tag=2.0-preview` is specified on the command l
``` yaml $(tag) == '2.0-preview'
input-file:
- - preview/1.0/render.json
- preview/2.0/render.json
```
+### Tag: 1.0-preview
+
+These settings apply only when `--tag=1.0-preview` is specified on the command line.
+
+``` yaml $(tag) == '1.0-preview'
+input-file:
+ - preview/1.0/render.json
+```
+
# Code Generation
## Swagger to SDK