Intro to the Basemaps API
Overview
The Streaming - Basemap API supports OGC requests for Vivid basemaps and seamlines. This API uses the Open Geospatial Consortium (OGC) API services Web Feature Service (WFS), Web Map Service (WMS) and Web Map Tile Service (WMTS) to provide Maxar's Vivid basemaps and seamlines and their metadata.
A Vivid Standard 30-centimeter imagery basemap with seamlines overlaid in the MGP Pro User Interface
Vivid Basemaps
Maxar Vivid Basemaps provide high-quality, visually consistent views of Earth. These basemaps are ideal for use as map contextual layers, for extracting map features at scale, and for visualization within an application. The following Vivid Basemaps are available to stream via MGP's OGC-compliant services:
| Vivid Basemap | Description |
|---|---|
| Vivid Advanced 15 cm HD | An imagery basemap with 15cm HD Product GSD and 5m CE90 accuracy, plus committed image currency and advanced aesthetics, including minimal clouds and shear. |
| Vivid Standard 30 cm HD | A global imagery basemap with 30 cm HD Product GSD and 5m CE90 accuracy, and includes the most recent imagery available that provides a high quality, clear view of the ground. |
Vivid Basemaps are available to stream via the following OGC-compliant streaming services.
| Service | Description | URL Path |
|---|---|---|
| Web Feature Service (WFS) | Provides the vector geometry and attributes of a feature in Geographic Markup Language (GML) format. | /basemaps/v1/ogc/wfs |
| Web Map Service (WMS) | Returns a map image in a standard image format. Images can be filtered by feature metadata. | /basemaps/v1/ogc/wms |
| Web Map Tile Service (WMTS) | Returns pre-generated images as map tiles. This service is optimized for faster server response times. | /basemaps/v1/ogc/gwc/service/wmts |
Vivid Seamlines
Seamlines show the boundaries of each segment of the imagery mosaic that make up the basemap. Use WFS to get the metadata for seamlines. WMS and WMTS return seamlines in raster format. Seamlines are available for each of the Vivid products listed above.
Vivid Seamlines are available to stream via the following OGC-compliant streaming services:
| Service | Description | URL Path | Documentation |
|---|---|---|---|
| Web Feature Service (WFS) | Provides the vector geometry and attributes of a feature in Geographic Markup Language (GML) format. | /basemaps/v1/seamlines/wfs | WFS Guide |
| Web Map Service (WMS) | Returns a map image in a standard image format. Images can be filtered by feature metadata. | /basemaps/v1/seamlines/ows?SERVICE=WMS | WMS Guide |
| Web Map Tile Service (WMTS) | Returns pre-generated images as map tiles. This service is optimized for faster server response times. | /basemaps/v1/seamlines/gwc/service/wmts | WMTS Guide |
Integration Examples
Leaflet Map
To use the Maxar:seamline layer in a Leaflet map, follow the Tutorial: Creating a Leaflet Map with WMS for instructions.
QGIS
To use WMTS or WMS in QGIS, See Tutorial: MGP QGIS Integration.
Additional MGP Services
Users who want to display map-like imagery base layer in an interface will want the Streaming - Imagery API instead. To obtain imagery not formatted for screen display, consider ordering images as files through the Ordering API or reading image data directly from the Raster Analytics service.