Skip to content

Tiles

Client Tiles Endpoint And CDN

Endpoint:

GET api/v9/content/published/clients/{clientIdentifier}/tiles

Description:

This endpoint provides URLs to access metadata and style information for map tiles associated with a specific client. The response contains structured URLs that can be used to Get the metadata.json and style.json files.

Success Response: 

{
  "mapMetaDataJsonUrl": "{cdnBaseUrl}/{clientIdentifier}/mbtiler/v9/versions/{version}/sites/{siteIdentifier}/tiles/metadata.json?{sasToken}",
  "styleWithMapMetadataJsonUrl": "{cdnBaseUrl}/{clientIdentifier}/style-with-map-metadata/v9/versions/{version}/sites/{siteIdentifier}/tiles/style.json?{sasToken}"
}

Response Fields

Field Type Description
mapMetaDataJsonUrl string URL template for the metadata.json file, which contains metadata for the map tiles.
styleWithMapMetadataJsonUrl string URL template for the style.json file, which defines the styling rules for the map tiles.

URL Template Explanation

The response provides URL templates with placeholders that must be replaced with actual values to Get the resources.

{cdnBaseUrl} → Base URL of the CDN serving the files.
{clientIdentifier} → Unique client identifier passed in the request.
{version} → Version of the map tile data.
{siteIdentifier} → Unique identifier of the site.
{sasToken} → Secure access token required for authorization.


* You can access the possible response codes you may encounter here.

CDN Hosted File:

The response of this API is also served as a static JSON file through a CDN. You can access the file using the following URL pattern:

GET {cdnBaseUrl}/{clientIdentifier}/published-content/v9/tiles/latest.json

Note

Access to the CDN file requires a valid SAS token. You must append ?{sasToken} to the URL when making a request to the CDN. Without a valid SAS token, access to the file will be denied.

Usage

  • This file allows clients to fetch the tile metadata and style information without making an API request.
  • It can be cached and served efficiently via CDN, reducing API load.
  • Clients can directly download and use this JSON file to determine the relevant URLs for map rendering.