This section describes how to use this API to request geospatial map tiles. You can try it out with a Free Trial Account.
Tiles API supports two request types:
- GetCapabilities
- GetTile
- URL Composition
- Base URL: https://api.cloud.precisely.com
- Tiles API:
/v1/spatial/wmts
- Supported Methods: GET
- Rate Limits (Transactions per second): 100
- Authentication and Input Fields: Data Integrity Suite's APIs provide multiple authentication methods. Whether you want to pass the API Key and Secret directly as part of the Basic Authentication header or use bearer tokens, you can do either using the same header. The two ways of authentication are:
- Basic Authentication (Using API Key and secret)
- Bearer Token Authentication
- Header Parameter: The following optional header parameter can be included in the requests.
Name Type Required Description X-Request-Id (header parameter)
string Optional This header is incredibly useful for developers. It serves as a unique identifier for requests within our system. When you encounter any problems with your requests, providing us with the X-Request-Id will enable us to pinpoint the specific request in question without the need for extensive manual searching. This means faster and more efficient troubleshooting.
The following sections describe the two request types supported by the Tiles API—GetCapabilities and GetTile. These requests allow clients to retrieve metadata about available tile layers and request specific tiles in supported formats. You can choose between a standard or simple profile based on your application's capabilities. The API also supports both image and vector tile formats to suit a wide range of visualization and styling needs.
Standard and Simple Profile Requests
The Tiles API supports both standard and simple profile requests.
- A simple profile request provides a streamlined version of the standard WMTS functionality. It is designed for easier integration with clients that do not support the full OGC WMTS specification.
- A standard request includes the complete set of features defined by the OGC WMTS standard. This includes support for advanced tile matrix definitions, configurations and additional options.
When you make a GetCapabilities request, the response includes separate URLs for both the standard and simple profile requests.
Supported Tile Formats
The Tiles API can return tiles in image and vector formats.
- Image tiles are provided in PNG format with a transparent background. Each tile is typically 256 × 256 pixels.
- Vector tiles are provided in MVT (Mapbox Vector Tile) format. These tiles contain vector data such as points, lines, and polygons. Clients like web browsers and mobile apps can style and interact with this data.
The GetCapabilities response includes a URL for each supported format.
Profiles and Formats in the GetCapabilities Response
The GetCapabilities response includes separate entries for each profile and format combination. For example, the following code snippet shows four entries for the adf-usa layer (Address Fabric™):
-
PNG format:
-
One for the standard profile
-
One for the simple profile
-
-
MVT format:
-
One for the standard profile
-
One for the simple profile
-
For example
<ResourceURL format="image/png" resourceType="tile" template="https://api-dev.cloud.precisely.services/v1/spatial/wmts/1.0.0/default/tiles/adf-usa/{style}/{TileMatrixSet}/{TileMatrix}/{TileCol}/{TileRow}.png"/>
<ResourceURL format="image/png" resourceType="simpleProfileTile" template="https://api-dev.cloud.precisely.services/v1/spatial/wmts/1.0.0/simpleProfileTile/tiles/adf-usa/{TileMatrix}/{TileCol}/{TileRow}.png"/>
<ResourceURL format="application/vnd.mapbox-vector-tile" resourceType="tile" template="https://api-dev.cloud.precisely.services/v1/spatial/wmts/1.0.0/default/tiles/adf-usa/{style}/{TileMatrixSet}/{TileMatrix}/{TileCol}/{TileRow}.mvt"/>
<ResourceURL format="application/vnd.mapbox-vector-tile" resourceType="simpleProfileTile" template="https://api-dev.cloud.precisely.services/v1/spatial/wmts/1.0.0/simpleProfileTile/tiles/adf-usa/{TileMatrix}/{TileCol}/{TileRow}.mvt"/>GetCapabilities response to discover available layers and formats.