openapi: 3.0.3
info:
title: Maxar Geospatial Platform Streaming API
description: >-
OGC Streaming services exposing Maxar's current and historical imagery as
WMS, WMTS and WFS layers — implemented behind securewatch.maxar.com and
surfaced through the MGP_SDK Python, Java and R clients. Profile derived
from the MGP_SDK README ("Open Geospatial Consortium standard protocols:
WFS, WMS, WMTS"); endpoint paths follow standard OGC URL patterns.
version: '1.0.0'
servers:
- url: https://securewatch.maxar.com/earthservice
description: Maxar SecureWatch
security:
- bearerAuth: []
- apiKeyAuth: []
tags:
- name: WMS
- name: WMTS
- name: WFS
- name: Image
paths:
/wmsaccess:
get:
tags: [WMS]
summary: WMS GetCapabilities or GetMap
description: >-
OGC Web Map Service entry point. Use `request=GetCapabilities` to list
layers or `request=GetMap` to render an image of an area of interest.
operationId: wmsAccess
parameters:
- { name: service, in: query, required: true, schema: { type: string, enum: [WMS] } }
- { name: request, in: query, required: true, schema: { type: string, enum: [GetCapabilities, GetMap, GetFeatureInfo] } }
- { name: version, in: query, schema: { type: string, default: '1.3.0' } }
- { name: layers, in: query, schema: { type: string } }
- { name: bbox, in: query, schema: { type: string } }
- { name: crs, in: query, schema: { type: string, example: EPSG:4326 } }
- { name: width, in: query, schema: { type: integer } }
- { name: height, in: query, schema: { type: integer } }
- { name: format, in: query, schema: { type: string, example: image/jpeg } }
responses:
'200':
description: WMS response
content:
image/jpeg: {}
image/png: {}
application/xml: {}
/wmtsaccess:
get:
tags: [WMTS]
summary: WMTS GetCapabilities or GetTile
operationId: wmtsAccess
parameters:
- { name: service, in: query, required: true, schema: { type: string, enum: [WMTS] } }
- { name: request, in: query, required: true, schema: { type: string, enum: [GetCapabilities, GetTile] } }
- { name: layer, in: query, schema: { type: string } }
- { name: tilematrixset, in: query, schema: { type: string, example: EPSG:3857 } }
- { name: tilematrix, in: query, schema: { type: string } }
- { name: tilerow, in: query, schema: { type: integer } }
- { name: tilecol, in: query, schema: { type: integer } }
- { name: format, in: query, schema: { type: string, example: image/png } }
responses:
'200':
description: WMTS response
content:
image/png: {}
image/jpeg: {}
application/xml: {}
/wfsaccess:
get:
tags: [WFS]
summary: WFS GetCapabilities or GetFeature
operationId: wfsAccess
parameters:
- { name: service, in: query, required: true, schema: { type: string, enum: [WFS] } }
- { name: request, in: query, required: true, schema: { type: string, enum: [GetCapabilities, GetFeature, DescribeFeatureType] } }
- { name: version, in: query, schema: { type: string, default: '2.0.0' } }
- { name: typeNames, in: query, schema: { type: string } }
- { name: bbox, in: query, schema: { type: string } }
- { name: outputFormat, in: query, schema: { type: string, example: application/json } }
- { name: count, in: query, schema: { type: integer } }
responses:
'200':
description: WFS response
content:
application/json: {}
application/xml: {}
/image:
get:
tags: [Image]
summary: Download Full Resolution Image
description: Download a full-resolution image of an area of interest, intersecting one or more catalog identifiers.
operationId: getImage
parameters:
- { name: bbox, in: query, required: true, schema: { type: string } }
- { name: image_id, in: query, schema: { type: string } }
- { name: format, in: query, schema: { type: string, enum: [jpeg, png, geotiff], default: geotiff } }
- { name: gsd, in: query, schema: { type: number, description: "Ground sample distance in metres" } }
responses:
'200':
description: Image binary
content:
image/tiff: {}
image/jpeg: {}
image/png: {}
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
apiKeyAuth:
type: apiKey
in: query
name: connectid