{ "info": { "_postman_id": "3b1d80b3-7014-4bbf-b34e-e004db579f9b", "name": "Microsoft Azure Azure Maps Spatial Service", "description": "Azure Maps Spatial REST APIs", "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "lastUpdatedBy": "35240", "uid": "35240-3b1d80b3-7014-4bbf-b34e-e004db579f9b" }, "item": [ { "name": "spatial", "item": [ { "name": "geofence", "item": [ { "name": "{format}", "item": [ { "name": "Microsoft Azure Get Spatial Geofence Format", "id": "c99e0dd6-fda2-48a6-9a2e-4776adb0a55c", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "id": "236615aa-0f76-42a6-b699-f0ab98da046b", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Search Geofence Get API**

**Applies to:** S1 Pricing tier.

The Geofence Get API allows you to retrieve the proximity of a coordinate to a
geofence that has been uploaded to the Data service. You can use the
[Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) to upload
a geofence or set of fences. See [Geofencing GeoJSON data](https://docs.microsoft.com/en-us/azure/azure-maps/geofence-geojson)
for more details on the geofence data format. To query the proximity of a coordinate, you supply the location of the object you are tracking as well
as the ID for the fence or set of fences, and the response will contain information about
the distance from the outer edge of the geofence. A negative value signifies that the
coordinate is inside of the fence while a positive value means that it is outside of the
fence.This API can be used for a variety of scenarios that include things like asset
tracking, fleet management, or setting up alerts for moving objects.

The API supports [integration with Event Grid](https://docs.microsoft.com/azure/azure-maps/azure-maps-event-grid-integration). The isAsync parameter is used to enable integration with Event Grid (disabled by default).
To test this API, you can upload the sample data from Post Geofence API examples (Request Body) via Data Upload API and replace the `{udid}` from the sample request below with the udid returned by Data Upload API.


### Geofencing InnerError code

In geofencing response error contract, `innererror` is an object containing service specific information about the error. `code` is a property in `innererror` which can map to a specific geofencing error type. The table belows shows the code mapping between all the known client error type to the corresponding geofencing error `message`.

innererror.code | error.message
---------------------------- | --------------------------------------
NullDeviceId | Device Id should not be null.
NullUdid\t | Udid should not be null.
UdidWrongFormat| Udid should be acquired from user data ingestion API.
InvalidUserTime| Usertime is invalid.
InvalidSearchBuffer| Searchbuffer is invalid.
InvalidSearchRange| The value range of searchbuffer should be from 0 to 500 meters.
InvalidLatLon| Lat and/or lon parameters are invalid.
InvalidIsAsyncValue| The IsAsync parameter is invalid.
InvalidModeValue| The mode parameter invalid.
InvalidJson| Geofencing data is not a valid json file.
NotSupportedGeoJson| Geofencing data can't be read as a Feature or FeatureCollections.
InvalidGeoJson| Geofencing data is invalid.
NoUserDataWithAccountOrSubscription| Can't find user geofencing data with provided account-id and/or subscription-id.
NoUserDataWithUdid|\tCan't find user geofencing data with provided udId." }, "response": [ { "id": "ae6d5546-d588-4fb7-8525-b5289edc95e2", "name": "OK The X-Correlation-id header value is present in an async call's response and the Event Grid event data. It helps correlate the async call\u2019s response with the corresponding Event Grid event.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Value present in an async call's response and the Event Grid event data. It helps correlate the async call\u2019s response with the corresponding Event Grid event.", "type": "text/plain" }, "key": "X-Correlation-id", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"geometries\": [\n {\n \"deviceId\": \"\",\n \"udId\": \"\",\n \"geometryId\": \"\",\n \"distance\": \"\",\n \"nearestLat\": \"\",\n \"nearestLon\": \"\",\n \"nearestZ\": \"\"\n },\n {\n \"deviceId\": \"\",\n \"udId\": \"\",\n \"geometryId\": \"\",\n \"distance\": \"\",\n \"nearestLat\": \"\",\n \"nearestLon\": \"\",\n \"nearestZ\": \"\"\n }\n ],\n \"expiredGeofenceGeometryId\": [\n \"\",\n \"\"\n ],\n \"invalidPeriodGeofenceGeometryId\": [\n \"\",\n \"\"\n ],\n \"isEventPublished\": \"\"\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-ae6d5546-d588-4fb7-8525-b5289edc95e2" }, { "id": "ca3dd3bb-94a1-4b64-ae29-01e3e2186267", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-ca3dd3bb-94a1-4b64-ae29-01e3e2186267" }, { "id": "012f2b4d-e499-44f3-8078-6272dbb20ab7", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-012f2b4d-e499-44f3-8078-6272dbb20ab7" }, { "id": "4afc8298-0286-4c51-a21e-9a64880bf013", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-4afc8298-0286-4c51-a21e-9a64880bf013" }, { "id": "76452b7c-d799-460c-89b6-b295d644adf0", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-76452b7c-d799-460c-89b6-b295d644adf0" }, { "id": "521d2b61-6180-47a4-9f35-de9f3b0d2477", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&udId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion is used. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.Now.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-521d2b61-6180-47a4-9f35-de9f3b0d2477" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-c99e0dd6-fda2-48a6-9a2e-4776adb0a55c" }, { "name": "Microsoft Azure Post Spatial Geofence Format", "id": "17aeff17-cc22-4f9a-943c-89805efab4cb", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "id": "c47f71b8-53d7-4777-b688-3ae7cd89b083", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Search Geofence Post API**
**Applies to:** S1 Pricing tier.
The Geofence Post API allows you to retrieve the proximity of a coordinate to a provided geofence or set of fences. With POST call, you do not have to upload the fence data in advance, instead you supply the location of the object you are tracking in query parameters as well as the fence or set of fences data in post request body. See [Geofencing GeoJSON data](https://docs.microsoft.com/en-us/azure/azure-maps/geofence-geojson) for more details on the geofence data format. The response will contain information about the distance from the outer edge of the geofence. A negative value signifies that the coordinate is inside of the fence while a positive value means that it is outside of the fence.This API can be used for a variety of scenarios that include things like asset tracking, fleet management, or setting up alerts for moving objects.

The API supports [integration with Event Grid](https://docs.microsoft.com/azure/azure-maps/azure-maps-event-grid-integration). The isAsync parameter is used to enable integration with Event Grid (disabled by default)." }, "response": [ { "id": "3d69a2d3-bb33-43a8-b020-dec199f58422", "name": "OK The X-Correlation-id header value is present in an async call's response and the Event Grid event data. It helps correlate the async call\u2019s response with the corresponding Event Grid event.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Value present in an async call's response and the Event Grid event data. It helps correlate the async call\u2019s response with the corresponding Event Grid event.", "type": "text/plain" }, "key": "X-Correlation-id", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"geometries\": [\n {\n \"deviceId\": \"\",\n \"udId\": \"\",\n \"geometryId\": \"\",\n \"distance\": \"\",\n \"nearestLat\": \"\",\n \"nearestLon\": \"\",\n \"nearestZ\": \"\"\n },\n {\n \"deviceId\": \"\",\n \"udId\": \"\",\n \"geometryId\": \"\",\n \"distance\": \"\",\n \"nearestLat\": \"\",\n \"nearestLon\": \"\",\n \"nearestZ\": \"\"\n }\n ],\n \"expiredGeofenceGeometryId\": [\n \"\",\n \"\"\n ],\n \"invalidPeriodGeofenceGeometryId\": [\n \"\",\n \"\"\n ],\n \"isEventPublished\": \"\"\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-3d69a2d3-bb33-43a8-b020-dec199f58422" }, { "id": "4893a8e7-a083-4f20-8aec-6449a90bd3e4", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-4893a8e7-a083-4f20-8aec-6449a90bd3e4" }, { "id": "c61b44d9-c39c-4254-be3f-8527584488a4", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-c61b44d9-c39c-4254-be3f-8527584488a4" }, { "id": "a97a5b87-fa97-4d2f-a169-9a14bf127e44", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-a97a5b87-fa97-4d2f-a169-9a14bf127e44" }, { "id": "2bfe2ff0-6a9e-4e72-9132-f0df1f0297ef", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-2bfe2ff0-6a9e-4e72-9132-f0df1f0297ef" }, { "id": "ffb2a8e9-ed23-4453-8973-96e354a1a02e", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/geofence/:format?subscription-key=&api-version=1.0&deviceId=&lat=&lon=&z=&userTime=&searchBuffer=50&isAsync=false&mode=EnterAndExit", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "geofence", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) ID of the device", "key": "deviceId", "value": "" }, { "description": "(Required) The latitude of the location being passed. Example: 48.36.", "key": "lat", "value": "" }, { "description": "(Required) The longitude of the location being passed. Example: -124.63.", "key": "lon", "value": "" }, { "description": "The sea level in meter of the location being passed. If this parameter is presented, 2D extrusion geofencing is applied. Example: 200.", "key": "z", "value": "" }, { "description": "The user request time. If not presented in the request, the default value is DateTime.UtcNow.", "key": "userTime", "value": "" }, { "description": "The radius of the buffer around the geofence in meters that defines how far to search inside and outside the border of the fence against the coordinate that was provided when calculating the result. The minimum value is 0, and the maximum is 500. The default value is 50.", "key": "searchBuffer", "value": "50" }, { "description": "If true, the request will use async event mechanism; if false, the request will be synchronized and do not trigger any event. The default value is false.", "key": "isAsync", "value": "false" }, { "description": "Mode of the geofencing async event mechanism.", "key": "mode", "value": "EnterAndExit" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-ffb2a8e9-ed23-4453-8973-96e354a1a02e" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-17aeff17-cc22-4f9a-943c-89805efab4cb" } ], "id": "95394cc3-3d14-4734-8655-6dcb38d72464", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-95394cc3-3d14-4734-8655-6dcb38d72464" } ], "id": "7b3b3e76-78c4-40f9-b1a3-0a7adffc0e4e", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-7b3b3e76-78c4-40f9-b1a3-0a7adffc0e4e" }, { "name": "buffer", "item": [ { "name": "{format}", "item": [ { "name": "Microsoft Azure Post Spatial Buffer Format", "id": "8f999825-4b6b-4cd2-a9f8-b102dad88663", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "id": "76cd6e0d-c520-403f-878b-c007b0e0da84", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API returns a FeatureCollection where each Feature is a buffer around the corresponding indexed Feature of the input. The buffer could be either on the outside or the inside of the provided Feature, depending on the distance provided in the input. There must be either one distance provided per Feature in the FeatureCollection input, or if only one distance is provided, then that distance is applied to every Feature in the collection. The positive (or negative) buffer of a geometry is defined as the Minkowski sum (or difference) of the geometry with a circle of radius equal to the absolute value of the buffer distance. The buffer API always returns a polygonal result. The negative or zero-distance buffer of lines and points is always an empty polygon. The input may contain a collection of Point, MultiPoint, Polygon, MultiPolygon, LineString and MultiLineString. GeometryCollection will be ignored if provided." }, "response": [ { "id": "e2ec678e-003a-400e-94fd-10b5669b83c4", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"udid\": \"\",\n \"information\": \"\"\n },\n \"result\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"Point\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"Polygon\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-e2ec678e-003a-400e-94fd-10b5669b83c4" }, { "id": "5a43a73d-d4bd-40bd-aa96-432b2f9cea99", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-5a43a73d-d4bd-40bd-aa96-432b2f9cea99" }, { "id": "8e64bb54-7160-4276-ada5-0aced8607db6", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-8e64bb54-7160-4276-ada5-0aced8607db6" }, { "id": "1c1985f5-8c5f-42c0-a818-9bf8cc982e07", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-1c1985f5-8c5f-42c0-a818-9bf8cc982e07" }, { "id": "ab3f5dd3-b2e9-4549-b82b-c6ac9daa0b80", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-ab3f5dd3-b2e9-4549-b82b-c6ac9daa0b80" }, { "id": "2a4dd1c7-82a5-4e3c-a688-85aae2703751", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"geometries\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiPoint\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n },\n \"distances\": [\n \"\",\n \"\"\n ]\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-2a4dd1c7-82a5-4e3c-a688-85aae2703751" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-8f999825-4b6b-4cd2-a9f8-b102dad88663" }, { "name": "Microsoft Azure Get Spatial Buffer Format", "id": "e4223fb7-331e-4b69-ac4c-292ceae65016", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "id": "ad75855d-91b1-4ad5-a1dc-8879bc5fdebf", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API returns a FeatureCollection where each Feature is a buffer around the corresponding indexed Feature of the input. The buffer could be either on the outside or the inside of the provided Feature, depending on the distance provided in the input. There must be either one distance provided per Feature in the FeatureCollection input, or if only one distance is provided, then that distance is applied to every Feature in the collection. The positive (or negative) buffer of a geometry is defined as the Minkowski sum (or difference) of the geometry with a circle of radius equal to the absolute value of the buffer distance. The buffer API always returns a polygonal result. The negative or zero-distance buffer of lines and points is always an empty polygon. The input features are provided by a GeoJSON file which is uploaded via [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) and referenced by a unique udid. The GeoJSON file may contain a collection of Point, MultiPoint, Polygon, MultiPolygon, LineString and MultiLineString. GeometryCollection will be ignored if provided.

To test this API, you can upload the sample data from [Post Buffer API](https://docs.microsoft.com/en-us/rest/api/maps/spatial/postbuffer#examples) examples (Request Body without distances array) via [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) and replace the `{udid}` from the [sample request below](https://docs.microsoft.com/en-us/rest/api/maps/spatial/getbuffer#examples) with the udid returned by Data Upload API." }, "response": [ { "id": "216dfb77-e62d-4716-a96a-7e92b0544963", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"udid\": \"\",\n \"information\": \"\"\n },\n \"result\": {\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"Point\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"Polygon\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-216dfb77-e62d-4716-a96a-7e92b0544963" }, { "id": "ff4da503-5739-4dd7-9966-aba3675e6d4b", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-ff4da503-5739-4dd7-9966-aba3675e6d4b" }, { "id": "7b61f381-c21c-4b24-9066-48d09a97030b", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-7b61f381-c21c-4b24-9066-48d09a97030b" }, { "id": "538bedfc-861b-4cf8-990a-ad41ad1d32fc", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-538bedfc-861b-4cf8-990a-ad41ad1d32fc" }, { "id": "ff206492-b7af-4d63-8ce9-41342929e221", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-ff206492-b7af-4d63-8ce9-41342929e221" }, { "id": "34b1b85b-831f-4f8f-b59e-aeff66eabc46", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/buffer/:format?subscription-key=&api-version=1.0&udid=&distances=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "buffer", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The list of distances (one per feature or one for all features), delimited by semicolons. For example, 12.34;-56.78. Positive distance will generate a buffer outside of the feature, whereas negative distance will generate a buffer inside of the feature. If the negative distance larger than the geometry itself, an empty polygon will be returned.", "key": "distances", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-34b1b85b-831f-4f8f-b59e-aeff66eabc46" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-e4223fb7-331e-4b69-ac4c-292ceae65016" } ], "id": "2010d620-d748-4345-97ee-0946c2012bbf", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-2010d620-d748-4345-97ee-0946c2012bbf" } ], "id": "d4473240-7129-4935-8887-2a1c7dba10db", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-d4473240-7129-4935-8887-2a1c7dba10db" }, { "name": "closestPoint", "item": [ { "name": "{format}", "item": [ { "name": "Microsoft Azure Post Spatial Closestpoint Format", "id": "310e49a0-995b-4e48-b7dd-cd0cfc61d3c1", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "id": "6103dc89-6ab7-4ff7-ad8a-1c6085f6473d", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API returns the closest point between a base point and a given set of target points. The set of target points is provided by user data in post request body. The user data may only contain a collection of Point geometry. MultiPoint or other geometries will be ignored if provided. The algorithm does not take into account routing or traffic. The maximum number of points accepted is 100,000. Information returned includes closest point latitude, longitude, and distance in meters from the closest point." }, "response": [ { "id": "184069fa-1bfd-4448-b716-5bab41454cfc", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"sourcePoint\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"udid\": \"\",\n \"information\": \"\"\n },\n \"result\": [\n {\n \"distanceInMeters\": \"\",\n \"position\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"geometryId\": \"\"\n },\n {\n \"distanceInMeters\": \"\",\n \"position\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"geometryId\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-184069fa-1bfd-4448-b716-5bab41454cfc" }, { "id": "0e121414-85f2-449c-892d-6c6125bf9fa4", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-0e121414-85f2-449c-892d-6c6125bf9fa4" }, { "id": "a00fea1f-05fb-47b1-9382-92c44327ddd2", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-a00fea1f-05fb-47b1-9382-92c44327ddd2" }, { "id": "eccb9c28-525a-4955-a76f-011f8ebe851c", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-eccb9c28-525a-4955-a76f-011f8ebe851c" }, { "id": "a468679c-c9c1-4b31-b7e1-cfdb1734ce03", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-a468679c-c9c1-4b31-b7e1-cfdb1734ce03" }, { "id": "f7e78ec2-6ce4-475f-9c79-81736501a579", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-f7e78ec2-6ce4-475f-9c79-81736501a579" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-310e49a0-995b-4e48-b7dd-cd0cfc61d3c1" }, { "name": "Microsoft Azure Get Spatial Closestpoint Format", "id": "6e01dd94-ac88-47ed-a7e9-194d270acf3e", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "id": "ba6e5889-ddb3-4069-841d-affb2f9320c8", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API returns the closest point between a base point and a given set of points in the user uploaded data set identified by udid. The set of target points is provided by a GeoJSON file which is uploaded via [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) and referenced by a unique udid. The GeoJSON file may only contain a collection of Point geometry. MultiPoint or other geometries will be ignored if provided. The maximum number of points accepted is 100,000. The algorithm does not take into account routing or traffic. Information returned includes closest point latitude, longitude, and distance in meters from the closest point.

To test this API, you can upload the sample data from [Post Closest Point API](https://docs.microsoft.com/en-us/rest/api/maps/spatial/postclosestpoint#examples) examples (Request Body) via [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) and replace the `{udid}` from the [sample request below](https://docs.microsoft.com/en-us/rest/api/maps/spatial/getclosestpoint#examples) with the udid returned by Data Upload API." }, "response": [ { "id": "53aa97f5-c574-4728-9abe-49baef6eeefd", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"sourcePoint\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"udid\": \"\",\n \"information\": \"\"\n },\n \"result\": [\n {\n \"distanceInMeters\": \"\",\n \"position\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"geometryId\": \"\"\n },\n {\n \"distanceInMeters\": \"\",\n \"position\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"geometryId\": \"\"\n }\n ]\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-53aa97f5-c574-4728-9abe-49baef6eeefd" }, { "id": "d70f2a17-4e65-4a5b-9efc-4fc62f859388", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-d70f2a17-4e65-4a5b-9efc-4fc62f859388" }, { "id": "debec028-43be-4700-a5ed-617a43d55026", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-debec028-43be-4700-a5ed-617a43d55026" }, { "id": "3f6b7061-cee5-430b-a66b-b1cd3bd0a0c0", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-3f6b7061-cee5-430b-a66b-b1cd3bd0a0c0" }, { "id": "be5021a4-0f73-4119-bbb5-3cc5d0283c85", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-be5021a4-0f73-4119-bbb5-3cc5d0283c85" }, { "id": "09f8aa87-d805-4094-af85-1351b9d8dbf9", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/closestPoint/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=&numberOfClosestPoints=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "closestPoint", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" }, { "description": "The number of closest points expected from response. Default: 1, minimum: 1 and maximum: 50", "key": "numberOfClosestPoints", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-09f8aa87-d805-4094-af85-1351b9d8dbf9" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-6e01dd94-ac88-47ed-a7e9-194d270acf3e" } ], "id": "5f69fd37-86d0-4257-9140-e4290d6c1565", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-5f69fd37-86d0-4257-9140-e4290d6c1565" } ], "id": "34f22f76-f73b-4a52-9613-c1b665cbeb9e", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-34f22f76-f73b-4a52-9613-c1b665cbeb9e" }, { "name": "pointInPolygon", "item": [ { "name": "{format}", "item": [ { "name": "Microsoft Azure Post Spatial Pointinpolygon Format", "id": "e5ce5223-2e96-48d6-b4cf-094e59883f74", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "id": "203b02da-3ecb-4200-8a27-67f5af2f80c4", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API returns a boolean value indicating whether a point is inside a set of polygons. The user data may contain Polygon and MultiPolygon geometries, other geometries will be ignored if provided. If the point is inside or on the boundary of one of these polygons, the value returned is true. In all other cases, the value returned is false. When the point is inside multiple polygons, the result will give intersecting geometries section to show all valid geometries (referenced by geometryId) in user data. The maximum number of vertices accepted to form a Polygon is 10,000." }, "response": [ { "id": "11909234-5905-4906-846b-a1398166ce35", "name": "OK", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"sourcePoint\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"udid\": \"\",\n \"information\": \"\"\n },\n \"result\": {\n \"pointInPolygons\": \"\",\n \"intersectingGeometries\": [\n \"\",\n \"\"\n ]\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-11909234-5905-4906-846b-a1398166ce35" }, { "id": "a65e7a43-e1f3-4d12-abda-cf624bacefed", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-a65e7a43-e1f3-4d12-abda-cf624bacefed" }, { "id": "92e425b6-dc16-4887-a65a-13e138315ad3", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-92e425b6-dc16-4887-a65a-13e138315ad3" }, { "id": "3289fb0e-7485-4390-b750-c70fd5405666", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-3289fb0e-7485-4390-b750-c70fd5405666" }, { "id": "92163035-cce8-47cf-88e2-4e8c5d78645f", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-92163035-cce8-47cf-88e2-4e8c5d78645f" }, { "id": "54399629-5f91-4411-a1e3-183cd6d4a202", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "POST", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Content-Type", "value": "application/json" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "body": { "mode": "raw", "raw": "{\n \"features\": [\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n },\n {\n \"type\": \"\",\n \"geometry\": {\n \"type\": \"MultiLineString\"\n },\n \"properties\": {}\n }\n ],\n \"type\": \"\"\n}", "options": { "raw": { "headerFamily": "json", "language": "json" } } }, "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-54399629-5f91-4411-a1e3-183cd6d4a202" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-e5ce5223-2e96-48d6-b4cf-094e59883f74" }, { "name": "Microsoft Azure Get Spatial Pointinpolygon Format", "id": "66d0b6ea-874f-4265-8377-17f770ed49b3", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "id": "15e0522a-9a1b-4189-8e2c-b5511c81f63d", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API returns a boolean value indicating whether a point is inside a set of polygons. The set of polygons is provided by a GeoJSON file which is uploaded via [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) and referenced by a unique udid. The GeoJSON file may contain Polygon and MultiPolygon geometries, other geometries will be ignored if provided. If the point is inside or on the boundary of one of these polygons, the value returned is true. In all other cases, the value returned is false. When the point is inside multiple polygons, the result will give intersecting geometries section to show all valid geometries(referenced by geometryId) in user data. The maximum number of vertices accepted to form a Polygon is 10,000.


To test this API, you can upload the sample data from [Post Point In Polygon API](https://docs.microsoft.com/en-us/rest/api/maps/spatial/postpointinpolygon#examples) examples (Request Body) via [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) and replace the `{udid}` from the [sample request below](https://docs.microsoft.com/en-us/rest/api/maps/spatial/getpointinpolygon#examples) with the udid returned by Data Upload API." }, "response": [ { "id": "90e35bc4-a1ff-4927-ac22-8dc5a97dec9b", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"sourcePoint\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"udid\": \"\",\n \"information\": \"\"\n },\n \"result\": {\n \"pointInPolygons\": \"\",\n \"intersectingGeometries\": [\n \"\",\n \"\"\n ]\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-90e35bc4-a1ff-4927-ac22-8dc5a97dec9b" }, { "id": "499141eb-6a60-46d6-95bc-3bb4b9feed34", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-499141eb-6a60-46d6-95bc-3bb4b9feed34" }, { "id": "eff8ea09-265f-4a91-a029-073e9f5a936b", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-eff8ea09-265f-4a91-a029-073e9f5a936b" }, { "id": "f7cdeca2-355b-46ed-9a8f-4c1d2f439f7e", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-f7cdeca2-355b-46ed-9a8f-4c1d2f439f7e" }, { "id": "8b078b03-17b3-4eae-987e-0d594017884e", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-8b078b03-17b3-4eae-987e-0d594017884e" }, { "id": "0a37bdcf-0132-40a4-9f5d-f0a6fd4a76f8", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/pointInPolygon/:format?subscription-key=&api-version=1.0&udid=&lat=&lon=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "pointInPolygon", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The unique id returned from [Data Upload API](https://docs.microsoft.com/en-us/rest/api/maps/data/uploadPreview) after uploading a valid GeoJSON FeatureCollection object. Please refer to [RFC 7946](https://tools.ietf.org/html/rfc7946#section-3.3) for details. All the feature's properties should contain `geometryId`, which is used for identifying the geometry and is case-sensitive.", "key": "udid", "value": "" }, { "description": "(Required) The base point latitude of the location being passed. Example: 47.622942.", "key": "lat", "value": "" }, { "description": "(Required) The base point longitude of the location being passed. Example: -122.316456.", "key": "lon", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-0a37bdcf-0132-40a4-9f5d-f0a6fd4a76f8" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-66d0b6ea-874f-4265-8377-17f770ed49b3" } ], "id": "1fc81d82-ef35-40b5-8a42-757f53e9445e", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-1fc81d82-ef35-40b5-8a42-757f53e9445e" } ], "id": "3036cf01-4ff0-44bb-989f-76660cf98e6f", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-3036cf01-4ff0-44bb-989f-76660cf98e6f" }, { "name": "greatCircleDistance", "item": [ { "name": "{format}", "item": [ { "name": "Microsoft Azure Get Spatial Greatcircledistance Format", "id": "c9b24945-7868-4256-b2c0-189c03710ed2", "protocolProfileBehavior": { "disableBodyPruning": true }, "request": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "id": "c3546177-4543-48d0-ad84-53ee44f2cbd6", "key": "format", "value": "json", "description": "(Required) Desired format of the response. Only `json` format is supported." } ] }, "description": "**Applies to**: S1 pricing tier.

This API will return the great-circle or shortest distance between two points on the surface of a sphere, measured along the surface of the sphere. This differs from calculating a straight line through the sphere's interior. This method is helpful for estimating travel distances for airplanes by calculating the shortest distance between airports." }, "response": [ { "id": "93a13a4d-6e5c-456e-9376-6ad737988585", "name": "OK", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "OK", "code": 200, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"summary\": {\n \"sourcePoint\": {\n \"lat\": \"\",\n \"lon\": \"\"\n },\n \"targetPoint\": {\n \"lat\": \"\",\n \"lon\": \"\"\n }\n },\n \"result\": {\n \"distanceInMeters\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-93a13a4d-6e5c-456e-9376-6ad737988585" }, { "id": "a70ef23a-ad28-41b2-bb13-9850c8a6b099", "name": "Bad request: one or more parameters were incorrectly specified or are mutually exclusive.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Bad Request", "code": 400, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-a70ef23a-ad28-41b2-bb13-9850c8a6b099" }, { "id": "8834d470-3e19-4424-9781-f5de1ee9b55f", "name": "Access denied due to invalid subscription key or invalid Microsoft Entra ID bearer token. Make sure to provide a valid key for an active Azure subscription and Maps resource. Otherwise, verify the [WWW-Authenticate](https://tools.ietf.org/html/rfc6750#s", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Unauthorized", "code": 401, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" }, { "disabled": false, "description": { "content": "Bearer realm=\"https://atlas.microsoft.com/\", error=\"invalid_token\", error_description=\"The access token expired\"", "type": "text/plain" }, "key": "WWW-Authenticate", "value": "" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-8834d470-3e19-4424-9781-f5de1ee9b55f" }, { "id": "8f545998-9971-4a2a-a6f0-7a731a97be8f", "name": "Permission, capacity, or authentication issues.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Forbidden", "code": 403, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-8f545998-9971-4a2a-a6f0-7a731a97be8f" }, { "id": "cb93dc41-c7d0-4537-9ad0-56469c9e8b3f", "name": "Not Found: the requested resource could not be found, but it may be available again in the future.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Not Found", "code": 404, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-cb93dc41-c7d0-4537-9ad0-56469c9e8b3f" }, { "id": "8e7395f4-7b77-4e45-9840-549fbbcec3e7", "name": "An error occurred while processing the request. Please try again later.", "originalRequest": { "method": "GET", "header": [ { "description": "Specifies which account is intended for usage in conjunction with the Microsoft Entra ID security model. It represents a unique ID for the Azure Maps account and can be retrieved from the Azure Maps management plane Account API. To use Microsoft Entra ID security in Azure Maps see the following [articles](https://aka.ms/amauthdetails) for guidance.", "key": "x-ms-client-id", "value": "" }, { "key": "Accept", "value": "application/json" }, { "description": "Added as a part of security scheme: oauth2", "key": "Authorization", "value": "" } ], "url": { "raw": "{{baseUrl}}/spatial/greatCircleDistance/:format?subscription-key=&api-version=1.0&query=", "host": [ "{{baseUrl}}" ], "path": [ "spatial", "greatCircleDistance", ":format" ], "query": [ { "description": "One of the Azure Maps keys provided from an Azure Map Account. Please refer to this [article](https://docs.microsoft.com/azure/azure-maps/how-to-manage-authentication) for details on how to manage authentication.", "key": "subscription-key", "value": "" }, { "description": "(Required) Version number of Azure Maps API. Current version is 1.0", "key": "api-version", "value": "1.0" }, { "description": "(Required) The Coordinates through which the distance is calculated, delimited by a colon. Two coordinates are required. The first one is the source point coordinate and the last is the target point coordinate. For example, 47.622942,122.316456:57.673988,127.121513", "key": "query", "value": "" } ], "variable": [ { "key": "format" } ] } }, "status": "Internal Server Error", "code": 500, "_postman_previewlanguage": "json", "header": [ { "key": "Content-Type", "value": "application/json" } ], "cookie": [], "responseTime": null, "body": "{\n \"error\": {\n \"code\": \"\",\n \"message\": \"\",\n \"details\": [\n {\n \"value\": \"\"\n },\n {\n \"value\": \"\"\n }\n ],\n \"target\": \"\"\n }\n}", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-8e7395f4-7b77-4e45-9840-549fbbcec3e7" } ], "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-c9b24945-7868-4256-b2c0-189c03710ed2" } ], "id": "7d4d344c-4d07-455e-83ff-aab2a148b0be", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-7d4d344c-4d07-455e-83ff-aab2a148b0be" } ], "id": "29bf919c-a45d-4efc-9eef-2724008ba05f", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-29bf919c-a45d-4efc-9eef-2724008ba05f" } ], "id": "94aa441a-55d7-4c61-affc-5a99db4580a9", "createdAt": "2026-06-05T15:19:33.000Z", "updatedAt": "2026-06-05T15:19:33.000Z", "uid": "35240-94aa441a-55d7-4c61-affc-5a99db4580a9" } ], "auth": { "type": "oauth2", "oauth2": [ { "key": "scope", "value": "https://atlas.microsoft.com/.default", "type": "string" }, { "key": "authUrl", "value": "https://login.microsoftonline.com/common/oauth2/authorize", "type": "string" }, { "key": "grant_type", "value": "implicit", "type": "string" } ] }, "variable": [ { "key": "baseUrl", "value": "https://atlas.microsoft.com" } ] }