Seamlines WFS
Overview
Seamline data is available for Vivid Basemaps from the basemaps/v1/seamlines endpoint of the Streaming - Basemap API. While seamlines can be returned from WMS or WMTS in raster format, vector seamlines from WFS are more performant and provide the relevant data about the seamlines.
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 capabilities available for WFS. | https://api.maxar.com/basemaps/v1/seamlines/wfs?request=GetCapabilities |
| Describe Feature Type | Returns the properties available for each supported feature type. | https://api.maxar.com/basemaps/v1/seamlines/wfs?request=DescribeFeatureType |
| GetFeature | Returns image features and their attributes. | https://api.maxar.com/basemaps/v1/seamlines/wfs?request=GetFeature |
WFS Get Capabilities
Returns a list of services and operations supported by the WFS.
Request URL
https://api.maxar.com/basemaps/v1/seamlines/wfs?service=WFS&request=GetCapabilities&version=2.0.0
Query parameters
| Name | Required/Optional | Description | Value |
|---|---|---|---|
| service | required | The 3-letter acronym for the requested OGC service. | wfs |
| request | required | The name of the WFS request type | GetCapabilities |
| version | required | The version number of the service | Accepts 1.0.0, 1.1.0, 2.0.0 |
Response
Response output format: XML
Successful status code: 200 OK
Exceptions may also return a 200 OK, with an error in the response body.
WFS Describe Feature Type
Returns a description of feature types supported by the WFS service. For online imagery, use the Feature type "seamline".
This example shows the Seamline description from the "DescribeFeatureType" response. Each line is an attribute of the feature type.
Feature Type: Seamline
<xsd:complexType name="seamlineType">
<xsd:complexContent>
<xsd:extension base="gml:AbstractFeatureType">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="seamline_geometry" nillable="true" type="gml:GeometryPropertyType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="create_date" nillable="true" type="xsd:dateTime"/>
<xsd:element maxOccurs="1" minOccurs="0" name="gsd" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="accuracy" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="acq_time_earliest" nillable="true" type="xsd:dateTime"/>
<xsd:element maxOccurs="1" minOccurs="0" name="acq_time_latest" nillable="true" type="xsd:dateTime"/>
<xsd:element maxOccurs="1" minOccurs="0" name="acq_time" nillable="true" type="xsd:dateTime"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sensor" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ona" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ona_avg" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sunel_avg" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sun_az_avg" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="target_az_avg" nillable="true" type="xsd:decimal"/>
<xsd:element maxOccurs="1" minOccurs="0" name="vehicle_name" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="product_name" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="product_create_time" nillable="true" type="xsd:dateTime"/>
<xsd:element maxOccurs="1" minOccurs="0" name="catid" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="block_name" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="active" nillable="true" type="xsd:boolean"/>
<xsd:element maxOccurs="1" minOccurs="0" name="block_base_name" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
Request URL
https://api.maxar.com/basemaps/v1/seamlines/wfs?service=WFS&request=DescribeFeatureType&version=2.0.0
Query parameters
| Name | Required/Optional | Description | Value |
|---|---|---|---|
| service | required | The requested OGC service. | wfs |
| request | required | The name of the WFS request type | DescribeFeatureType |
| version | required | The version number of the service. We recommend using the latest version, which is 2.0.0. | Accepts 1.0.0, 1.1.0, 2.0.0 |
| typename | required | The desired layer typename. | seamline |
| outputFormat | optional | The desired response output format. | json |
Response
Response output format: XML
Successful status code: 200 OK
Exceptions may also return a 200 OK, with an error in the response body.
WFS Get Feature
Returns metadata for Vivid Basemap seamlines.
Request URL
URL path with required parameters:
https://api.maxar.com/basemaps/v1/seamlines/wfs?service=WFS&request=GetFeature&version=2.0.0&typename=seamline&outputFormat=json&crs=EPSG:4326&cql_filter=product_name='VIVID_STANDARD_30' AND BBOX(seamline_geometry,39.906477,-105.010843,39.918031,-104.991939)
Query parameters
| Name | Required/Optional | Description | Value |
|---|---|---|---|
| service | required | The requested OGC service. | wfs |
| request | required | The service request type. | GetFeature |
| version | required | The OGC version to use for the request. | 2.0.0 |
bbox | required | The geographic extents of the features to return. | Example: 39.7530,-104.9962,39.7580,-104.9912 |
srsName | optional | This parameter is used to specify the spatial reference system to encode feature geometries in. | Accepts EPSG:4326 only. |
typeNames | required | To obtain the detailed metadata for one or more Features contained in a tile, use the WFS getFeature request, with a typeName of seamline. | seamline |
outputFormat | optional | Response output format. Default is text/xml; subtype=gml/3.1.1. | See Supported Output Formats. |
Example WFS Get Feature request URL
https://api.maxar.com/basemaps/v1/ogc/wfs?service=wfs&request=GetFeature&version=2.0.0&typeNames=Maxar:FinishedFeature&cql_Filter=BBOX(featureGeometry,39.7530,-104.9962,39.7580,-104.9912)AND(productName LIKE 'VIVID%')&sortBy=latestAcquisitionTime D&count=10
Supported output formats
The response to a WFS Get Feature query can be returned in a variety of formats. The default format is text/xml; subtype=gml/3.1.1.
Supported output formats
text/xml; subtype=gml/3.1.1
GML2
KML
SHAPE-ZIP
application/vnd.google-earth.kml xml
application/vnd.google-earth.kml+xml
csv
gml3
gml32
json
text/csv
text/xml; subtype=gml/2.1.2
text/xml; subtype=gml/3.2
The list of supported output formats for a WFS Get Feature request can also be found in the WFS Get Capabilities response.
Feature Type
The following WFS feature types are supported:
| Feature Type Name | Results | |
|---|---|---|
| Maxar:seamline | Returns seamline metadata for features of any Vivid product type. | |
| Maxar:VividAdvanced15Seamline | Returns seamline metadata for Vivid Advanced features. | |
| Maxar:VividStandard30Seamlines | Returns seamline metadata for Vivid Standard 30 features. |
This table describes the metadata associated with feature type Maxar:Seamline. A Feature can be produced from a single image or multiple images. To programmatically get a list of feature metadata, make a WFS "Describe Feature Type" request.
| Field | Description | Allowed Values |
|---|---|---|
create_date | The date and time the mosaic was created in Zulu time. | YYYY-MM-DDTHH:MM:SSSZ |
gsd | The spatial resolution of the image, stated in meters. | number |
accuracy | The spatial accuracy of the image, stated in meters. | number |
acq_time_earliest | The earliest date and time of acquisition of the image swath, in Zulu time. | YYYY-MM-DDTHH:MM:SSSZ |
acq_time_latest | The latest date and time of acquisition of the image swath, in Zulu time. | YYYY-MM-DDTHH:MM:SSSZ |
acq_time | The date and time the satellite acquired the image in Zulu time. | YYYY-MM-DDTHH:MM:SSSZ |
sensor | The sensor that acquired the image. | wv01 wv02 wv03_vnir ge01 qb02 lg01 lg02 lgO3 lg04 |
ona | Off-nadir angle: the angle from the sensor between nadir (straight down) and the scene center. Measured in degrees. | 0-90 |
ona_avg | Average off-nadir angle (as described above). | 0-90 |
sunel_avg | The average sun elevation: the angle from the tangent of the scene center point to the sun. Measured from the horizon in degrees. | 0-90 |
sun_az_avg | The average sun azimuth: from the scene center point on the ground, this is the angle between truth north and the sun. Measured clockwise in degrees. | 0-360 |
target_az_avg | The average target azimuth: from the scene center point on the ground, this is the angle between truth north and the satellite. Measured clockwise in degrees. | 0-360 |
vehicle_name | The satellite that acquired the image. | worldview-01 worldview-02 worldview-03 geoeye-01 quickbird-02 legion-01 legion-02 legion-O3 legion-04 |
product_name | The name of the mosaic product. | string |
product_create_time | The date and time the image mosaic was created in Zulu time. | YYYY-MM-DDTHH:MM:SSSZ |
catid | Catalog ID of the image. | string |
block_name | Name of the production block. | string |
active | Active status | true, false |
block_base_name | Base name of the production block | string |