# Maps API

> Maps API on Apizie: 10 endpoints (Copyrights whole world, Captions, Copyrights bounding box, Copyrights tile, …) 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/places:tomtom-maps/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `places:tomtom-maps`
- Category: Places
- Status: byok
- Source: https://tomtom.com
- Page: https://zieapi.vercel.app/api/places/tomtom-maps
- OpenAPI: https://zieapi.vercel.app/api/places/tomtom-maps/openapi.json

The Maps API web services suite offers the following APIs: - Raster The Maps Raster API renders map data that is divided into gridded sections called tiles. Tiles are square images (png or jpg format) in various sizes…

## Endpoints

### Copyrights whole world
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-copyrights-format` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1 |
| format | string | yes | Format of the response |
| callback | string | no | Specifies the jsonp callback method. Only used when format is jsonp |

### Captions
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-copyrights-caption-format` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1. |
| format | string | yes | Format of the response |
| callback | string | no | Specifies the jsonp callback method. Only used when format is jsonp |

### Copyrights bounding box
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-copyrights-min-lon-min-lat-max-lon-ma` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1 |
| format | string | yes | Format of the response |
| minLon | number | yes | Minimum longitude coordinate of bounding box defined in terms of latitude/longitude. |
| minLat | number | yes | Minimum latitude coordinate of bounding box defined in terms of latitude/longitude. |
| maxLon | number | yes | Maximum longitude coordinate of bounding box defined in terms of latitude/longitude. |
| maxLat | number | yes | Maximum latitude coordinate of bounding box defined in terms of latitude/longitude. |
| callback | string | no | Specifies the jsonp callback method. Only used when format is jsonp. |

### Copyrights tile
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-copyrights-zoom-x-y-format` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1 |
| format | string | yes | Format of the response |
| zoom | integer | yes | Zoom level of tile to be rendered. Only used for tile-level copyright calls. |
| X | integer | yes | X coordinate of the tile on zoom grid. Only used for tile-level copyright calls. |
| Y | integer | yes | Y coordinate of the tile on zoom grid. Only used for tile-level copyright calls. |
| callback | string | no | Specifies the jsonp callback method. Only used when format is jsonp. |

### Static Image
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-staticimage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1. |
| layer | string | no | Layer of image to be rendered. Hybrid and labels are intended for layering with other data and are only available in png format. |
| style | string | no | Map style to be returned |
| format | string | no | Image format to be returned |
| zoom | integer | no | Zoom level of map image to be returned. |
| center | string | no | Coordinates for the center point of the image. Must be used with the width and height parameters; cannot be used with bbox . Uses… |
| width | integer | no | Width of the resulting image in pixels. Width must be a positive integer between 1 and 8192. |
| height | integer | no | Height of the resulting image in pixels. Height must be a positive integer between 1 and 8192. |
| bbox | string | no | Bounding box for the image, using EPSG:3857 projection (functionally equivalent to EPSG:900910). Values must be in the order of minLon,… |
| view | string | no | Geopolitical view. Determines rendering of disputed areas. See the documentation for an explanation of how this works in live services. |

### Tile
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-tile-layer-style-zoom-x-y-pbf` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1 |
| layer | string | yes | Layer of tile to be rendered |
| style | string | yes | Style of tile to be rendered |
| zoom | integer | yes | Zoom level of tile to be rendered |
| X | integer | yes | x coordinate of tile on zoom grid |
| Y | integer | yes | y coordinate of tile on zoom grid |
| view | string | no | Geopolitical view. Determines rendering of disputed areas. See the documentation for an explanation of how this works in live services. |
| language | string | no | Language to be used for labels in the response. The default is NGT: Neutral Ground Truth, which uses each place's local official language… |

### Tile
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-tile-layer-style-zoom-x-y-format` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1. |
| layer | string | yes | Layer of tile to be rendered. Hybrid and labels are intended for layering with other data and are only available in png format. |
| style | string | yes | Style of tile to be rendered |
| zoom | integer | yes | Zoom level of tile to be rendered |
| X | integer | yes | x coordinate of tile on zoom grid |
| Y | integer | yes | y coordinate of tile on zoom grid |
| format | string | yes | Format of the response. |
| tileSize | integer | no | Tile dimensions in pixels. 512 is only available for the main style and basic or labels layers. |
| view | string | no | Geopolitical view. Determines rendering of disputed areas. See the documentation for an explanation of how this works in live services. |

### GetMap
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1 |
| request | string | yes | Request type |
| srs | string | yes | Projection used in describing the bbox EPSG:3857 is recommended, particularly at higher zoom levels. (Note that EPSG:3857 is functionally… |
| bbox | string | yes | Bounding box in the projection stated in srs (minLon,minLat,maxLon,maxLat) |
| width | integer | yes | Width of the resulting image, in pixels Maximum value is 2048 |
| height | integer | yes | Height of the resulting image, in pixels Maximum value is 2048 |
| format | string | yes | Image format to be returned |
| layers | string | yes | Map layers requested Currently only the basic layer is available |
| styles | string | no | Map styles to be returned. Currently, no styles are available. This parameter is present for forward compatibility; it must be used and… |
| service | string | no | Service type |
| version | string | yes | WMS service version |

### GetCapabilities
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-capabilities` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes |  |
| service | string | yes |  |
| request | string | yes |  |
| version | string | no | WMS service version |

### WMTS
`GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-wmts-key-wmts-version-wmtscapabilitie` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| versionNumber | integer | yes | Version of the service to call. The current version is 1 |
| key | string | yes | Your API key for calling this service. |
| wmtsVersion | string | yes |  |

## Example
```
curl "https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-copyrights-format" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Maps API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/places:tomtom-maps/get-map-version-number-copyrights-format with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

### Can AI agents use the Maps 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 places:tomtom-maps.

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