# Maps Geolocation API

> Maps Geolocation API on Apizie: 1 endpoint (Use to get the ISO country/region code for a given IP address.) 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-geolocation/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Azure Maps Geolocation REST APIs

## Endpoints

### Use to get the ISO country/region code for a given IP address.
`GET https://zieapi.vercel.app/v1/cloud:azure-maps-geolocation/geolocation-get-ipto-location` (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 | Indicates the account intended for use with the Microsoft Entra ID security model. This unique ID for the Azure Maps account can be… |
| format | string | yes | Desired format of the response. Only `json` format is supported. |
| ip | string | yes | The IP address. Both IPv4 and IPv6 are allowed. |

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

## FAQ

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

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

### Can AI agents use the Maps Geolocation 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-geolocation.

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