Seamlines WMTS
Overview
The Web Map Tile Service (WMTS) returns image tiles divided on a pre-defined grid matrix. These tile matrix sets are available in Geographic (EPSG:4326) and Web Mercator (EPSG:3857 and EPSG:900913) systems in standard and 2X (Retina) resolutions. See the list of supported tile matrix sets.
Each tile within the set is identified by a numeric row and column value. The zoom level the tile column and tile row apply to must also be specified. Zoom levels 0 (lowest) to 21 (highest, fully zoomed in) are supported.
Other than returning tiles, the WMTS service functions similarly to the WMS service to render the Maxar:seamline layer.
Authentication
All OGC services accept an API key or a bearer token for authentication.
Bearer tokens
Maxar Oauth bearer tokens can also be used to authenticate API requests. Bearer tokens have a brief duration and must be refreshed frequently.
To authenticate with a bearer token, use the Authorization header:
Authorization: Bearer <Oauth2 token>
Learn about OAuth2 bearer tokens
API keys
API keys can be passed using query parameters or in a custom header. No Authorization header is needed when using API keys.
To use the query parameter method, include this query parameter in your request:
maxar_api_key=<your API key>
The custom Maxar header takes the form of:
maxar-api-key: <your API key>
API keys expire 180 days from creation by default. A custom expiration date can be set but cannot exceed 180 days.
Learn about API keys
Services
| Name | Description | Request URL |
|---|---|---|
| Get Capabilities | Describes the Get Tile service and layers. | https://api.maxar.com/basemaps/v1/seamlines/gwc/service/wmts?SERVICE=WMTS&REQUEST=GetCapabilities&VERSION=1.0.0 |
| GetTile | Returns a seamless image tile | https://api.maxar.com/basemaps/v1/seamlines/gwc/service/wmts?request=GetTile |
WMTS Get Capabilities
Returns a list of services and operations supported by WMTS.
Request URL
https://api.maxar.com/basemaps/v1/seamlines/gwc/service/wmts?SERVICE=WMTS&REQUEST=GetCapabilities&VERSION=1.0.0
Query parameters
| Name | Required/Optional | Description | Value |
|---|---|---|---|
| service | required | The requested OGC service. | wmts |
| request | required | The name of the request type | GetCapabilities |
| version | required | The version number of the service | Use 1.0.0 |
Response
Successful status code: 200 OK
Response output format: XML
Exceptions may also return a 200 OK, with an error in the response body.
The response body is returned in XML format and describes the supported services and imagery layers.
WMTS Get Tile
Returns a map tile based on the input query parameters.
WMTS GetTile request parameters are explained in this section. You can also make a WMTS Get Capabilities request to see the details of the WMTS service.
Request URL
Example:
https://api.maxar.com/basemaps/v1/seamlines/gwc/service/wmts?service=WMTS&request=GetTile&version=1.0.0&layer=Maxar:seamline&format=image/jpeg&tileMatrixSet=EPSG:4326&tileMatrix=EPSG:4326:14&tileCol=6831&tileRow=4574&cql_filter=product_name='VIVD_STANDARD_30'
Query parameters
| Name | Required/Optional | Description | Value |
|---|---|---|---|
| service | required | The name of the OGC service. | wmts |
| request | required | The name of the WMTS request type. | GetTile |
| version | required | The version number of the service. | 1.0.0 |
| layer | required | The name of the imagery layer to query. | Use Maxar:seamline |
| tileMatrixSet | required | A pre-defined set of tiles for the spatial reference system.Supported tile matrix sets | EPSG:4326 |
| tileMatrix | required | The tile matrix set and and zoom level, from 0 (lowest) to 21 (highest). | EPSG:4326:14 |
| tileCol | required | The column index of a tile matrix. | 1709 |
| tileRow | required | The row index of a tile matrix. | 3100 |
| format | required | The output file format of the response. See Supported Output Formats. | image/jpeg |
| styles | optional | Renders the layers in the selected style. | raster |
Supported tile matrix sets
Supported tile matrix sets
EPSG:4326
EPSG:900913
Supported output formats
By default, a map tile is returned in PNG format. The JPEG format will return the fastest service response. PNG is required for tiles with transparent backgrounds.
Supported output formats
image/png
image/jpeg
Response
Successful response code: 200 OK
The response is an image of the requested map tile.