About Maxar APIs
The Maxar Geospatial Platform (MGP) APIs provide programmatic access to stream or order imagery and analytic data. Once a Customer account is set up, the "users" inside the account will use their credentials to get an access token. This token authorizes to access all APIs and services provisioned to your account.
To learn more about the content that is available, See Specifications.
Authentication
Access tokens
To access the APIs, use your account credentials (username and password) to get an OAuth2 bearer token from the Auth API. This token provides access to the APIs for a duration of time. You can fetch a new token or refresh your current token.
Learn more: Get a Token Tutorial
API keys
An API key can be used to authenticate a specific project, such as an application. API keys expire 180 days after creation by default. API keys can be used with any of the non-administrative MGP APIs.
Learn more: API keys
Discovery API
The Discovery API enables searching, filtering, and sorting through a unified catalog of available content, including Core Imagery, Vivid Basemaps, Analysis-Ready Data (ARD), and Change Monitoring (CM). The Discovery API also returns metadata information with the selectable options about the available content as SpatioTemporal Asset Catalog (STAC) and GeoJSON. Some results sets return links to order or stream the selected content.
Streaming - Imagery API
The Streaming - Imagery API enables identification and streaming of Online Imagery strips. This API supports the Open Geospatial Consortium (OGC) API services WFS, WMS and WMTS.
See the Streaming - Imagery Guide
Streaming - Basemap API
The Streaming - Basemap API enables streaming of imagery Basemap products and associated product and source image metadata using OGC services.
See the Streaming - Basemap Guide
Streaming - 3D API
The Streaming - 3D API enables streaming of 3D Surface Models (3DSM). This API allows customers to visualize, analyze, and if included in your license agreement integrate with 3DSM data. This includes virtual and augmented reality experiences, interactive web-based maps, geospatial analysis tools, and any system that leverages the cesium platform.
See the Streaming - 3D Guide
Ordering API
The Ordering API enables ordering of content, with multiple delivery options. Each type of content has a dedicated "Pipeline" for processing and delivery. When you place an order, you will tell the Ordering API which pipeline to use for processing and delivering imagery by including the pipeline's "namespace" and "name in the Ordering path. Your order request will also include a "settings" object in a schema specific to the Pipeline.
See the Ordering Guide
See also: Pipeline-specific Ordering Guides
Ordering Analysis-Ready Data (ARD)
Ordering Change Monitoring (CM)
Monitoring API
The Monitoring API allows users to receive alerts when new data is available for ordering based on a registered Area of Interest (AOI) and specified criteria set by the user. When a Monitor finds a match, it sends a notification to Monitor's owner with information needed to place an order. Monitors can also include an ordering template that will order the matched imagery to the requested Content Pipeline, such as ARD or Core Imagery.
See the Monitoring Guide
Tasking API
Note: Tasking is currently only available as a limited release service.
The Tasking API provides the ability to request new imagery to be collected within a specified date range and AOI. A Tasking request will automatically trigger a Monitor (via the Monitoring API) that will look for matching imagery as new imagery is collected. Matching imagery will be automatically ordered to the requested pipeline. Supported pipelines are Analysis-Ready (ARD), System-Ready (1B), View-Ready (2A), View-Ready-Ortho (OR2A), and Map-Ready (3D).
See the Tasking Guide
Analytics API
Raster Analytics
The Raster Analytics API enables synchronous inferencing on imagery by selecting a catalog ID and an analytical operation. Synchronous inferencing includes operations for band manipulation, processing, and classification models. The Raster Analytics API supports the use of analysis graphs (e.g., NDVI and NDWI) to simplify analysis of the requested imagery.
See the Raster Analytics Guide
Vector Analytics
The Vector Analytics API enables synchronous grid-based access to Change Monitoring (CM) vector data via OGC WMS and WMTS standards.
Available Change Monitoring products:
-
CM Electro-Optical
-
CM Synthetic Aperture Radar
See the Vector Analytics Guide
Usage API
The Usage API allows account administrators to systematically generate reports for usage analysis. We recommend using the MGP Pro User Interface to view Usage reports. Usage data is also available through API requests.
See Usage Guide