# Maps Search API

> Maps Search API on Apizie: 6 endpoints (Use to get longitude and latitude coordinates of a street address or name of a place., Use to get ranked list of suggested entities based on a user's location and a partial query., Use to send a batch of queries to the [Geocoding](/rest/api/maps/search/get-geocoding) API in a single…, Use to get a street address and location info from longitude and latitude coordinates., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://zieapi.vercel.app/v1/cloud:azure-maps-search/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:azure-maps-search`
- Category: Cloud
- Status: byok
- Source: https://learn.microsoft.com/rest/api/azure/
- Page: https://zieapi.vercel.app/api/cloud/azure-maps-search
- OpenAPI: https://zieapi.vercel.app/api/cloud/azure-maps-search/openapi.json

Azure Maps Search REST APIs

## Endpoints

### Use to get longitude and latitude coordinates of a street address or name of a place.
`GET https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-geocoding` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| Accept-Language | string | no | Language in which search results should be returned. Please refer to [Supported… |
| top | integer | no | Maximum number of responses that will be returned. Default: 5, minimum: 1 and maximum: 20. |
| query | string | no | A string that contains information about a location, such as an address or landmark name. |
| addressLine | string | no | The official street line of an address relative to the area, as specified by the locality, or postalCode, properties. Typical use of this… |
| countryRegion | string | no | Signal for the geocoding result to an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that is… |
| bbox | array | no | A rectangular area on the earth defined as a bounding box object. The sides of the rectangle are defined by longitude and latitude values.… |
| view | string | no | A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter… |
| coordinates | array | no | A point on the earth specified as a longitude and latitude. When you specify this parameter, the user's location is taken into account and… |
| adminDistrict | string | no | The country subdivision portion of an address, such as WA. This parameter should not be used when the `query` parameter is included in the… |
| adminDistrict2 | string | no | The county for the structured address, such as King. This parameter should not be used when the `query` parameter is included in the… |
| adminDistrict3 | string | no | The named area for the structured address. This parameter should not be used when the `query` parameter is included in the request. |
| locality | string | no | The locality portion of an address, such as Seattle. This parameter should not be used when the `query` parameter is included in the… |
| postalCode | string | no | The postal code portion of an address. This parameter should not be used when the `query` parameter is included in the request. |
| x-ms-client-id | string | no | Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure… |

### Use to get ranked list of suggested entities based on a user's location and a partial query.
`GET https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-geocode-autocomplete` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| x-ms-client-id | string | no | Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure… |
| Accept-Language | string | no | Language in which search results should be returned. Please refer to [Supported… |
| query | string | yes | Required. The user's query prefix. Example: "1 Micro" or "Muir Woods". |
| coordinates | array | no | Required when `bbox` is not provided. A point on the earth specified as a longitude and latitude. When you specify this parameter, the… |
| bbox | array | no | Required when `coordinates` is not provided. A rectangular area on the earth defined as a bounding box object. The sides of the rectangle… |
| top | integer | no | Maximum number of responses that will be returned. Default: 5, minimum: 1 and maximum: 20. |
| resultTypeGroups | array | no | A comma separated list of returned entity type groups. The possible values are - Address - Place |
| resultTypes | array | no | A comma separated list of returned entity types. When type group is set to Address, the supported types are: - Address - RoadBlock All… |
| view | string | no | A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter… |
| countryRegion | string | no | Signal for the autocomplete result to an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) that… |

### Use to send a batch of queries to the [Geocoding](/rest/api/maps/search/get-geocoding) API in a single…
`POST https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-geocoding-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| x-ms-client-id | string | no | Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure… |
| Accept-Language | string | no | Language in which search results should be returned. Please refer to [Supported… |
| body | object | yes | JSON request body |

### Use to get a street address and location info from longitude and latitude coordinates.
`GET https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-reverse-geocoding` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| x-ms-client-id | string | no | Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure… |
| Accept-Language | string | no | Language in which search results should be returned. Please refer to [Supported… |
| coordinates | array | yes | The coordinates of the location that you want to reverse geocode. Example: &coordinates=lon,lat |
| resultTypes | array | no | Specify entity types that you want in the response. Only the types you specify will be returned. If the point cannot be mapped to the… |
| view | string | no | A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter… |

### Use to send a batch of queries to the [Reverse Geocoding](/rest/api/maps/search/get-reverse-geocoding) API…
`POST https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-reverse-geocoding-batch` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| x-ms-client-id | string | no | Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure… |
| Accept-Language | string | no | Language in which search results should be returned. Please refer to [Supported… |
| body | object | yes | JSON request body |

### Use to get polygon data of a geographical area shape such as a city or a country region.
`GET https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-polygon` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | The Azure Maps service hostname. Use `https://atlas.microsoft.com` for the Azure public cloud. To target a specific Azure Maps geography… |
| api-version | string | no | The API version to use for this operation. |
| x-ms-client-id | string | no | Specifies which account is intended for usage in conjunction with the Azure AD security model. It represents a unique ID for the Azure… |
| Accept-Language | string | no | Language in which search results should be returned. Please refer to [Supported… |
| coordinates | array | yes | A point on the earth specified as a longitude and latitude. Example: &coordinates=lon,lat |
| view | string | no | A string that represents an [ISO 3166-1 Alpha-2 region/country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2). This will alter… |
| resultType | string | no | The geopolitical concept to return a boundary for. If not specified, the default is `countryRegion` result type. |
| resolution | string | no | Resolution determines the amount of points to send back. If not specified, the default is medium resolution. |

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-geocoding" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Maps Search API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/cloud:azure-maps-search/search-get-geocoding with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Maps Search API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Maps Search itself also needs your own key from azure.com.

### Can AI agents use the Maps Search API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:azure-maps-search.

### What is the status of the Maps Search API?
Needs your own provider key (bring your own key)