Web Feature Service
The Maxar Web Feature Service (WFS) defines a set of functions that clients may use to return actual Features with geometry and attributes that can be used in any type of geospatial analysis.
Any client making requests that conform to the OGC WFS specification can interact with the WFS server. Web-based client/server architecture is a typical example of the structure of a Web Feature Service application.
Typical Structure of a WFS Application
In a WFS scenario, the client application requests desired information from the Web Feature Service server. The WFS server retrieves the appropriate information from the Feature store, including vector metadata and imagery footprints, and responds to the request with this information in a GML format.
WFS Client-Server Architecture
The following architecture depicts a sample integration of
The
Sample WFS Client Server Application
WFS Service Details
The Maxar
- GetCapabilities The GetCapabilities request is used to determine the supported FeatureTypes.
- DescribeFeatureType The DescribeFeatureType request is used to discover the properties available for a supported FeatureType.
- GetFeature The GetFeature request is used to get the properties of one or more instances of a supported FeatureType.
The Maxar WFS categorizes Features as one of the following types:
- FinishedFeature This Feature type provides users with access to all finished product data via a single Feature.
- TileMatrixFeature This Feature type provides users with access to all of the available metadata, for all of the Feature instances that occur in a particular tile.
- ImageInMosaicFeature This Feature type provides users with access to the seamline information that is available with mosaicked finished products.
MaxarCatalogMosaicProducts This Feature type provides users with access to Vivid Mosaic product metadata via a single Feature.
MaxarCatalogMosaicSeamlines This Feature type provides users with access to the seamline information that is available for each Vivid production block.
MaxarCatalogMosaicTiles This feature type provides users with access to information about Vivid Mosaic granules.
Integration Procedure
A WFS client application is a program that communicates with the WFS server using the three functions GetCapabilities, GetFeature and DescribeFeatureType, as noted earlier. More specifically, in a typical WFS client/server interaction, the following steps can be followed:
Step 1
The client first has to request GetCapabilities from the WFS server in order to determine what the WFS server can do and what Features the WFS server can provide.
The previous URL contains Base URL and few parameters as explained in Basic Service Elements. The key parameter for this request is "request=GetCapabilities" which fetches the capabilities of Web Feature Service and response back in the form of XML data.
| https://evwhs.digitalglobe.com/catalogservice/wfsaccess?SERVICE=WFS&REQUEST=GetCapabilities&VERSION=1.1.0&connectId=<CONNECTID> Note: Replace <CONNECTID> with the connectId provided by Maxar. Parameters are not required to be in the same order as shown above. |
In response to a GetCapabilities request, the WFS server produces an eXtensible Markup Language (XML) document containing the WFS server's service metadata, describing all the operations it supports, and providing information about the available Features. The client application has to parse the XML capabilities document to retrieve the necessary information used to request for a Feature. The Document Object Model (DOM) is a widely used and efficient XML parser, which can be utilized to parse the XML document and retrieve the information. The DOM represents an XML document as a tree of nodes that can be easily traversed and edited with its standard interfaces.
Response XML to GetCapabilities request contains the following details:
- WFS Service details like Name, Title, URL
- Contact Information Person, Organization, Address, Telephone, Fax and Email
- WFS Capabilities like GetCapabilties, GetFeature and DescribeFeatureInfo along with respective formats and URLs
<wfs:WFS_Capabilities version="2.0.0" xsi:schemaLocation="http://www.opengis.net/wfs/2.0 https://services-test.digitalglobe.com/catalogservice/schemas/wfs/2.0/wfs.xsd?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091" updateSequence="107">
<ows:ServiceIdentification>
<ows:Title>DigitalGlobe Web Feature Service</ows:Title>
<ows:Abstract/>
<ows:Keywords>
<ows:Keyword>WFS</ows:Keyword>
<ows:Keyword>WMS</ows:Keyword>
</ows:Keywords>
<ows:ServiceType>WFS</ows:ServiceType>
<ows:ServiceTypeVersion>2.0.0</ows:ServiceTypeVersion>
<ows:Fees>NONE</ows:Fees>
<ows:AccessConstraints>NONE</ows:AccessConstraints>
</ows:ServiceIdentification>
<ows:ServiceProvider>
<ows:ProviderName>DigitalGlobe Inc</ows:ProviderName>
<ows:ServiceContact>
<ows:IndividualName>Customer Service Department</ows:IndividualName>
<ows:PositionName>Customer Service Department</ows:PositionName>
<ows:ContactInfo>
<ows:Phone>
<ows:Voice>800.496.1225</ows:Voice>
<ows:Facsimile>303.684.4562</ows:Facsimile>
</ows:Phone>
<ows:Address>
<ows:DeliveryPoint/>
<ows:City/>
<ows:AdministrativeArea/>
<ows:PostalCode/>
<ows:Country/>
<ows:ElectronicMailAddress>info@maxar.com</ows:ElectronicMailAddress>
</ows:Address>
</ows:ContactInfo>
</ows:ServiceContact>
</ows:ServiceProvider>
<ows:OperationsMetadata>
<ows:Constraint name="ImplementsBasicWFS">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsTransactionalWFS">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsLockingWFS">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="KVPEncoding">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="XMLEncoding">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="SOAPEncoding">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsInheritance">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsRemoteResolve">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsResultPaging">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsStandardJoins">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsSpatialJoins">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsTemporalJoins">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ImplementsFeatureVersioning">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="ManageStoredQueries">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="PagingIsTransactionSafe">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="QueryExpressions">
<ows:AllowedValues>
<ows:Value>wfs:Query</ows:Value>
<ows:Value>wfs:StoredQuery</ows:Value>
</ows:AllowedValues>
</ows:Constraint>
<ows:Operation name="GetCapabilities">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
<ows:Post xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="AcceptVersions">
<ows:AllowedValues>
<ows:Value>1.0.0</ows:Value>
<ows:Value>1.1.0</ows:Value>
<ows:Value>2.0.0</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
<ows:Parameter name="AcceptFormats">
<ows:AllowedValues>
<ows:Value>text/xml</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
<ows:Parameter name="Sections">
<ows:AllowedValues>
<ows:Value>ServiceIdentification</ows:Value>
<ows:Value>ServiceProvider</ows:Value>
<ows:Value>OperationsMetadata</ows:Value>
<ows:Value>FeatureTypeList</ows:Value>
<ows:Value>Filter_Capabilities</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
</ows:Operation>
<ows:Operation name="DescribeFeatureType">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
<ows:Post xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="outputFormat">
<ows:AllowedValues>
<ows:Value>application/gml+xml; version=3.2</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
</ows:Operation>
<ows:Operation name="GetFeature">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
<ows:Post xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="resultType">
<ows:AllowedValues>
<ows:Value>results</ows:Value>
<ows:Value>hits</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
<ows:Parameter name="outputFormat">
<ows:AllowedValues>
<ows:Value>application/gml+xml; version=3.2</ows:Value>
<ows:Value>GML2</ows:Value>
<ows:Value>KML</ows:Value>
<ows:Value>SHAPE-ZIP</ows:Value>
<ows:Value>application/atom xml</ows:Value>
<ows:Value>application/atom+xml</ows:Value>
<ows:Value>application/json</ows:Value>
<ows:Value>application/rss xml</ows:Value>
<ows:Value>application/rss+xml</ows:Value>
<ows:Value>application/vnd.google-earth.kml xml</ows:Value>
<ows:Value>application/vnd.google-earth.kml+xml</ows:Value>
<ows:Value>atom</ows:Value>
<ows:Value>csv</ows:Value>
<ows:Value>gml3</ows:Value>
<ows:Value>gml32</ows:Value>
<ows:Value>json</ows:Value>
<ows:Value>rss</ows:Value>
<ows:Value>text/xml; subtype=gml/2.1.2</ows:Value>
<ows:Value>text/xml; subtype=gml/3.1.1</ows:Value>
<ows:Value>text/xml; subtype=gml/3.2</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
<ows:Parameter name="featureProfile"/>
<ows:Constraint name="PagingIsTransactionSafe">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</ows:Constraint>
<ows:Constraint name="CountDefault">
<ows:NoValues/>
<ows:DefaultValue>1000000</ows:DefaultValue>
</ows:Constraint>
</ows:Operation>
<ows:Operation name="GetPropertyValue">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
<ows:Post xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
</ows:HTTP>
</ows:DCP>
<ows:Parameter name="resolve">
<ows:AllowedValues>
<ows:Value>none</ows:Value>
<ows:Value>local</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
<ows:Parameter name="outputFormat">
<ows:AllowedValues>
<ows:Value>application/gml+xml; version=3.2</ows:Value>
</ows:AllowedValues>
</ows:Parameter>
</ows:Operation>
<ows:Operation name="ListStoredQueries">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
<ows:Post xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
</ows:HTTP>
</ows:DCP>
</ows:Operation>
<ows:Operation name="DescribeStoredQueries">
<ows:DCP>
<ows:HTTP>
<ows:Get xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
<ows:Post xlink:href="https://services-test.digitalglobe.com/catalogservice/wfsaccess?CONNECTID=d78805a5-d1f6-4014-9fc0-68884bbd4091"/>
</ows:HTTP>
</ows:DCP>
</ows:Operation>
</ows:OperationsMetadata>
<FeatureTypeList>
<FeatureType>
<Name>DigitalGlobe:BasicFeature</Name>
<Title>BasicFeature</Title>
<Abstract>Generated from CatalogService</Abstract>
<ows:Keywords>
<ows:Keyword>CatalogService</ows:Keyword>
<ows:Keyword>BasicFeature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:CollectedContent</Name>
<Title>CollectedContent</Title>
<Abstract>Generated from CatalogService</Abstract>
<ows:Keywords>
<ows:Keyword>CatalogService</ows:Keyword>
<ows:Keyword>CollectedContent</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:PCMChangePolygons</Name>
<Title>DigitalGlobe:PCMChangePolygons</Title>
<Abstract>PCM change polygons from Landsat via MDA</Abstract>
<ows:Keywords>
<ows:Keyword>features</ows:Keyword>
<ows:Keyword>PCMChangePolygons</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:FinishedFeature</Name>
<Title>FinishedFeature</Title>
<Abstract>Generated from CatalogService</Abstract>
<ows:Keywords>
<ows:Keyword>CatalogService</ows:Keyword>
<ows:Keyword>FinishedFeature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:ImageInMosaicFeature</Name>
<Title>ImageInMosaicFeature</Title>
<Abstract>Generated from CatalogService</Abstract>
<ows:Keywords>
<ows:Keyword>CatalogService</ows:Keyword>
<ows:Keyword>ImageInMosaicFeature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:MaxarCatalogMosaicProducts</Name>
<Title>Maxar Catalog Mosaic Products</Title>
<Abstract>Mosaic Products</Abstract>
<ows:Keywords>
<ows:Keyword>features</ows:Keyword>
<ows:Keyword>mosaic_product_feature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:MaxarCatalogMosaicSeamlines</Name>
<Title>Maxar Catalog Mosaic Seamlines</Title>
<Abstract>Mosaic Seamlines</Abstract>
<ows:Keywords>
<ows:Keyword>features</ows:Keyword>
<ows:Keyword>mosaic_seamline_feature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:MaxarCatalogMosaicTiles</Name>
<Title>Maxar Catalog Mosaic Tiles</Title>
<Abstract>Mosaic Tiles</Abstract>
<ows:Keywords>
<ows:Keyword>features</ows:Keyword>
<ows:Keyword>mosaic_product_tile_feature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:StandardFeature</Name>
<Title>StandardFeature</Title>
<Abstract>Generated from CatalogService</Abstract>
<ows:Keywords>
<ows:Keyword>CatalogService</ows:Keyword>
<ows:Keyword>StandardFeature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
<FeatureType>
<Name>DigitalGlobe:TileMatrixFeature</Name>
<Title>TileMatrixFeature</Title>
<Abstract>Generated from CatalogService</Abstract>
<ows:Keywords>
<ows:Keyword>CatalogService</ows:Keyword>
<ows:Keyword>TileMatrixFeature</ows:Keyword>
</ows:Keywords>
<DefaultCRS>urn:ogc:def:crs:EPSG::4326</DefaultCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3857</OtherCRS>
<OtherCRS>urn:ogc:def:crs:EPSG::3395</OtherCRS>
<OtherCRS>urn:ogc:def:crs:OGC:1.3:AUTO42004</OtherCRS>
<Operations>
<Operation>Query</Operation>
</Operations>
<ows:WGS84BoundingBox>
<ows:LowerCorner>-180.0 -90.0</ows:LowerCorner>
<ows:UpperCorner>180.0 90.0</ows:UpperCorner>
</ows:WGS84BoundingBox>
</FeatureType>
</FeatureTypeList>
<fes:Filter_Capabilities>
<fes:Conformance>
<fes:Constraint name="ImplementsQuery">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsAdHocQuery">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsFunctions">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsMinStandardFilter">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsStandardFilter">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsMinSpatialFilter">
<ows:NoValues/>
<ows:DefaultValue>TRUE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsSpatialFilter">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsMinTemporalFilter">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsTemporalFilter">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsVersionNav">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsSorting">
<ows:AllowedValues>
<ows:Value>ASC</ows:Value>
<ows:Value>DESC</ows:Value>
</ows:AllowedValues>
<ows:DefaultValue>ASC</ows:DefaultValue>
</fes:Constraint>
<fes:Constraint name="ImplementsExtendedOperators">
<ows:NoValues/>
<ows:DefaultValue>FALSE</ows:DefaultValue>
</fes:Constraint>
</fes:Conformance>
<fes:Id_Capabilities>
<fes:ResourceIdentifier name="fes:ResourceId"/>
</fes:Id_Capabilities>
<fes:Scalar_Capabilities>
<fes:LogicalOperators/>
<fes:ComparisonOperators>
<fes:ComparisonOperator name="PropertyIsLessThan"/>
<fes:ComparisonOperator name="PropertyIsGreaterThan"/>
<fes:ComparisonOperator name="PropertyIsLessThanOrEqualTo"/>
<fes:ComparisonOperator name="PropertyIsGreaterThanOrEqualTo"/>
<fes:ComparisonOperator name="PropertyIsEqualTo"/>
<fes:ComparisonOperator name="PropertyIsNotEqualTo"/>
<fes:ComparisonOperator name="PropertyIsBetween"/>
<fes:ComparisonOperator name="PropertyIsNull"/>
</fes:ComparisonOperators>
</fes:Scalar_Capabilities>
<fes:Spatial_Capabilities>
<fes:GeometryOperands>
<fes:GeometryOperand name="gml:Polygon"/>
</fes:GeometryOperands>
<fes:SpatialOperators>
<fes:SpatialOperator name="Equals"/>
<fes:SpatialOperator name="Crosses"/>
<fes:SpatialOperator name="Overlaps"/>
<fes:SpatialOperator name="DWithin"/>
<fes:SpatialOperator name="BBOX"/>
<fes:SpatialOperator name="Beyond"/>
<fes:SpatialOperator name="Within"/>
<fes:SpatialOperator name="Contains"/>
<fes:SpatialOperator name="Disjoint"/>
<fes:SpatialOperator name="Touches"/>
<fes:SpatialOperator name="Intersects"/>
</fes:SpatialOperators>
</fes:Spatial_Capabilities>
<fes:Functions/>
</fes:Filter_Capabilities>
</wfs:WFS_Capabilities>
Step 2
The client can request GetFeature with the WFS server's capabilities information in order to get the Feature information. Once a user has obtained a description of the supported FeatureType, the GetFeature request is used to access the metadata associated with one or more Feature instances. Subsets of Features can be obtained by providing filtering information in the request. Available filtering capability includes:
- Filtering on a list of specific Feature IDs
- Filtering based on a geographic area (Bounding Box)
- Filtering based on Feature property values (e.g., only return Features with a Cloud Cover of less than 5%)
| https://evwhs.digitalglobe.com/catalogservice/wfsaccess?SERVICE=WFS&REQUEST=GetFeature&maxFeatures=25&typeName=DigitalGlobe:FinishedFeature&VERSION=1.1.0&connectId=<CONNECTID>&BBOX=39.346038,-105.424805,40.131711,-104.545898 Note: Replace <CONNECTID> with the connectId provided by Maxar. Parameters are not required to be in the same order as shown above. |
The Parameters available in the GetFeature request are shown in Table 4.6. The client provides the following information in a Key-Value Pair (KVP) format, where the "name" field is the key, and the "value" field is the value; the data is supplied in the format "key=value"; for example, "service=WFS".
In response to a valid GetFeature request, the WFS returns a GML document containing zero or more Features that match the request criteria. Each Feature is described by a list of properties contained in a GML document.
The available properties are defined in the PropertyName field of the GetFeature Request above. An example Feature in GML format is as follows:
<?xml version="1.0" encoding="UTF-8"?>
<wfs:FeatureCollection
xmlns:DigitalGlobe="http://www.digitalglobe.com"
xmlns:ogc="http://www.opengis.net/ogc"
xmlns:gml="http://www.opengis.net/gml"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:ows="http://www.opengis.net/ows"
xmlns:wfs="http://www.opengis.net/wfs" numberOfFeatures="1" timeStamp="2010-10-29T12:34:08.004Z"
xsi:schemaLocation="http://www.digitalglobe.com https://evwhs.digitalglobe.com/catalogservice/wfsaccess?connectId=<CONNECTID>&service=WFS&version=1.1.0&request=DescribeFeatureType&typeName=DigitalGlobe:FinishedFeature http://www.opengis.net/wfs http://evwhs.digitalglobe.com:80/wfsservice/schemas/wfs/1.1.0/wfs.xsd">
<gml:featureMember>
<DigitalGlobe:featureId>3e437526446504b1b8c2e1b9033a3375
</DigitalGlobe:featureId>
<DigitalGlobe:geometry>
<gml:Polygon srsName="urn:x-ogc:def:crs:EPSG:4326">
<gml:exterior>
<gml:LinearRing>
<gml:posList>39.94609069824219 -105.49018859863281 40.139949798583984 -105.49018859863281 40.139949798583984 -105.23181915283203 39.9460906982421 -105.23181915283203 39.94609069824219 -105.49018859863281 </gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:Polygon>
</DigitalGlobe:geometry>
<DigitalGlobe:offNadirAngle>28.562355</DigitalGlobe:offNadirAngle>
<DigitalGlobe:sunElevation>49.5492</DigitalGlobe:sunElevation>
<DigitalGlobe:cloudCover>7.0088723E-4</DigitalGlobe:cloudCover>
<DigitalGlobe:sunAzimuth>154.9179</DigitalGlobe:sunAzimuth>
<DigitalGlobe:source>QB02</DigitalGlobe:source>
<DigitalGlobe:sourceUnit>Strip</DigitalGlobe:sourceUnit>
<DigitalGlobe:productType>Pan Sharpened Natural Color </DigitalGlobe:productType>
<DigitalGlobe:groundSampleDistance>0.6</DigitalGlobe:groundSampleDistance>
<DigitalGlobe:groundSampleDistanceUnit>Meter</DigitalGlobe:groundSampleDistanceUnit>
<DigitalGlobe:dataLayer>crisis_event</DigitalGlobe:dataLayer>
<DigitalGlobe:legacyDescription/>
<DigitalGlobe:outputMosaic>false</DigitalGlobe:outputMosaic>
<DigitalGlobe:colorBandOrder>RGB</DigitalGlobe:colorBandOrder>
<DigitalGlobe:assetName>FINISHED</DigitalGlobe:assetName>
<DigitalGlobe:assetType>PRODUCT_GEOMETRY</DigitalGlobe:assetType>
<DigitalGlobe:legacyId>101001000C4DBF00</DigitalGlobe:legacyId>
<DigitalGlobe:factoryOrderNumber>052405468-10</DigitalGlobe:factoryOrderNumber>
<DigitalGlobe:acquisitionDate>2010-09-17 17:51:33.28</DigitalGlobe:acquisitionDate>
<DigitalGlobe:perPixelX>5.399999998E-6</DigitalGlobe:perPixelX>
<DigitalGlobe:perPixelY>-5.399999998E-6</DigitalGlobe:perPixelY>
<DigitalGlobe:crsFromPixels>EPSG:4326</DigitalGlobe:crsFromPixels>
<DigitalGlobe:url/>
<DigitalGlobe:ageDays>41</DigitalGlobe:ageDays>
<DigitalGlobe:formattedDate>2010-09-17</DigitalGlobe:formattedDate>
</gml:featureMember>
</wfs:FeatureCollection>
If additional metadata about either all Features in a particular tile, or a single Feature included in a particular tile is needed, it can be retrieved from G-EGD using a WFS getFeature Request.
To obtain all of the available metadata, for all of the Feature instances that occur in a particular tile, use the WFS getFeature request, with a typeName of TileMatrixFeature.
| https://evwhs.digitalglobe.com/catalogservice/wfsaccess?request=GetFeature&typeName=DigitalGlobe:TileMatrixFeature&SERVICE=WFS&VERSION=1.1.0&connectId=<CONNECTID>&CQL_FILTER=layer='DigitalGlobe:ImageryTileService'and%20tileMatrixSet%20=%20'EPSG:3857'%20and%20tileMatrix%20=%20'EPSG:3857:17'%20and%20row%20=%2058685%20and%20column%20=%2039235 Note: Replace <CONNECTID> with the connectId provided by Maxar. Parameters are not required to be in the same order as shown above. CQL_FILTER parameters define the exact tile of interest, by using: the layer: DigitalGlobe:ImageryTileService the tileMatrixSet: EPSG:3857 the tileMatrix: EPSG:3857:17 the tile row:58685 for this example the tile column: 39235 for this example. |
The response is a Maxar TileMatrixFeature, which provides both summary metadata for the defined tile and detailed metadata for each Feature that appears in the tile.
| The data returned would represent the CURRENT tile that would be produced by G-EGD. In order to ensure that this matches the customer tile for the desired metadata, the customer must compare the tileIdentifier in the WFS return, with the tileIdentifier for metadata being requested. If the tileIdentifiers do NOT match, then the data in the Maxar system has changed since the initial tile delivery. |
To obtain the detailed metadata for one or more Features contained in a tile, use the WFS getFeature request, with a typeName of FinishedFeature.
| https://evwhs.digitalglobe.com/catalogservice/wfsaccess?SERVICE=WFS&request=GetFeature&version=1.1.0&typeName=DigitalGlobe:FinishedFeature&srsName=EPSG:3857&outputFormat=text/xml;subtype=gml/3.1.1&featureId=<FEATUREID>&connectId=<CONNECTID> Note: Replace <CONNECTID> with the connectId provided by Maxar. Parameters are not required to be in the same order as shown above. <FEATUREID> is a comma-delimited list of Feature IDs for which metadata is desired; these can be obtained from the <featureInTileIdentifier> field of the tile_master.lst file. |
For the complete list of supported outputFormat types, use the WFS "GetCapabilities".
To search for all Vivid Standard products in a specific area, apply a CQL filter for products that INTERSECT a polygon WKT, and ensure the product_line_name field is equal to 'Vivid 3.0'. To modify the following call, copy in a new polygon WKT.
| https://evwhs.digitalglobe.com/catalogservice/wfsaccess?connectid=<CONNECTID>&service=WFS&version=2.0.0&request=GetFeature&TYPENAME=MaxarCatalogMosaicProducts&cql_filter=(INTERSECTS(shape,POLYGON((-121.924341 46.712138,-121.415079 46.741033,-121.245229 47.019181,-121.220339 47.21135,-121.602689 48.311741,-122.290192 48.622357,-122.369156 48.631888,-122.516785 48.520129,-122.56073 48.422708,-122.848821 47.114737,-122.842167 47.01981,-122.834871 46.992082,-121.977556 46.714492,-121.924341 46.712138)))AND(product_line_name = 'Vivid 3.0')) Note: Replace <CONNECTID> with the connectId provided by Maxar. Parameters are not required to be in the same order as shown above. <FEATUREID> is a comma-delimited list of Feature IDs for which metadata is desired; these can be obtained from the <featureInTileIdentifier> field of the tile_master.lst file. |
Step 3
To get the description of the supported FeatureType, the user can use the following URL:
| https://evwhs.digitalglobe.com/catalogservice/wfsaccess?service=WFS&request=DescribeFeatureType&version=1.1.0&typeName=DigitalGlobe:FinishedFeature&connectId=<CONNECTID> Note: Replace <CONNECTID> with the connectId provided by Maxar. Parameters are not required to be in the same order as shown above. |
The parameters available in the DescribeFeatureType request are shown in API Reference. The client provides the following information in a Key-Value Pair (KVP) format, where the "name" field is the key, and the "value" field is the value; the data is supplied in the format "key=value"; for example, "service=WFS".
In response to a DescribeFeatureType request, a GML document is returned that defines the elements of the requested Feature Type. The elements of each supported Feature type are defined in API Reference. Where returned data is dependent on the value of elements within the Feature, the dependency is noted in the Description column. Example output is shown below.
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:DigitalGlobe="http://www.digitalglobe.com" xmlns:gml="http://www.opengis.net/gml" elementFormDefault="qualified" targetNamespace="http://www.digitalglobe.com">
<xsd:import namespace="http://www.opengis.net/gml" schemaLocation="http://evwhs.digitalglobe.com:80/wfsservice/schemas/gml/3.1.1/base/gml.xsd"/>
<xsd:complexType name="FinishedFeatureType">
<xsd:complexContent>
<xsd:extension base="gml:AbstractFeatureType">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="featureId" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="geometry" nillable="true" type="gml:PolygonPropertyType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="offNadirAngle" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sunElevation" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cloudCover" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sunAzimuth" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="source" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sourceUnit" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="productType" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="groundSampleDistance" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="groundSampleDistanceUnit" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dataLayer" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="legacyDescription" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="outputMosaic" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="legacyId" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="colorBandOrder" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="assetName" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="assetType" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="factoryOrderNumber" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="acquisitionDate" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="perPixelX" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="perPixelY" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="crsFromPixels" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="URL" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="ageDays" nillable="true" type="xsd:int"/>
<xsd:element maxOccurs="1" minOccurs="0" name="formattedDate" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:element name="FinishedFeature" substitutionGroup="gml:_Feature" type="DigitalGlobe:FinishedFeatureType"/>
</xsd:schema>
Example output follows.
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:DigitalGlobe="http://www.digitalglobe.com"
xmlns:gml="http://www.opengis.net/gml" elementFormDefault="qualified" targetNamespace="http://www.digitalglobe.com">
<xsd:import namespace="http://www.opengis.net/gml" schemaLocation="http://evwhs.digitalglobe.com:80/wfsservice/schemas/gml/3.1.1/base/gml.xsd"/>
<xsd:complexType name="ImageInMosaicFeatureType">
<xsd:complexContent>
<xsd:extension base="gml:AbstractFeatureType">
<xsd:sequence>
<xsd:element maxOccurs="1" minOccurs="0" name="featureId" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="parentFeatureId" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="dataLayer" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="geometry" nillable="true" type="gml:PolygonPropertyType"/>
<xsd:element maxOccurs="1" minOccurs="0" name="assetName" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="assetType" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="URL" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="legacyId" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="acquisitionDate" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="cloudCover" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="offNadirAngle" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sunElevation" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="sunAzimuth" nillable="true" type="xsd:string"/>
<xsd:element maxOccurs="1" minOccurs="0" name="source" nillable="true" type="xsd:string"/>
</xsd:sequence>
</xsd:extension>
</xsd:complexContent>
</xsd:complexType>
<xsd:element name="ImageInMosaicFeature" substitutionGroup="gml:_Feature" type="DigitalGlobe:ImageInMosaicFeatureType"/>
</xsd:schema>
Service Exceptions
In the event that a Web
An <ExceptionReport> element will contain one or more
The following is an example of an exception report. This exception indicates that the first insert statement failed because of a missing closing XML tag in the request.
<?xml version="1.0" ?>
<ExceptionReport version="1.1.0" xmlns="http://www.opengis.net/ogc"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="owsExceptionReport.xsd">
<Exception code="999" locator="INSERT STMT 01">
<ExceptionText>
parse error: missing closing tag for element Geom
</ExceptionText>
</Exception>
</ExceptionReport>
API Reference
API reference gives the list of all possible request parameters for every WFS operation and detailed information about corresponding response.
The client should provide the respective information in a Key-Value Pair (KVP) format for every WFS request, where the "name" field is the key, and the "value" field is the value; the data is supplied in the format "key=value"; for example, "service=WFS".
The following table shows all possible request parameters for GetCapabilities operation of WFS server.
Name | Value | Short Description |
---|---|---|
CONNECTID* | <CONNECTID> provided by Maxar | Value for this parameter is a unique 32-digit alphanumeric value given by Maxar (see Connect ID). A valid Connect ID is mandatory for every request. |
SERVICE* | WFS | See Service. |
REQUEST* | GetCapabilities | The value for this parameter should always be "GetCapabilities" for step 1. |
VERSION* | 1.1.0 | See Version. |
*mandatory parameter
Name | Value | Short Description | ||
---|---|---|---|---|
Service* | WFS | Web Feature Service | ||
Version* | 1.1.0 | Request version | ||
Request* | GetFeature | Request name | ||
resultType | Possible values:
| A value of results generates full results set response; A value of hits returns only a count of the number of Features that match the request. results is the default | ||
maxFeatures | An integer | The maximum number of Features that will be returned; if not specified the default is to return all results | ||
srsName | EPSG:4326 EPSG::3395 EPSG::3857 | This is the SRS in which the Feature data will be returned. Only one SRS is supported, and EPSG:4326 is the default if no SRS is specified. Complete list of supported values are found in the GetCapabilities response. | ||
typeName* | FinishedFeature TileMatrixFeature ImageInMosaicFeature MaxarCatalogMosaicProducts MaxarCatalogMosaicSeamlines MaxarCatalogMosaicTiles | The Feature type for which results will be returned. | ||
featureId (Mutually exclusive with FILTER and BBOX) | List of featrureIds: featureIds are the ID Property of the Feature. For example: 17027d713c0c3d9eaef07e80d959e347 | Specific Feature instances for which results will be returned.
| ||
FILTER (Prerequisite: TYPENAME) (Mutually exclusive with FEATUREID and BBOX) | Filter specification including properties and values to be filtered on; Any of the properties returned in the DescribeFeatureType response can be used as Filter parameters Note that if a FILTER is supplied, FEATUREID and BBOX may NOT be used in the same request; however, a BBOX may be supplied within the filter in order to accomplish the same capability | For details of the filter format, see the OGC WFS specification. | ||
WIDTH and HEIGHT* | WIDTH=1102 HEIGHT=712 Integer number of pixels to be returned in the X (Width) and Y (Height) coordinates | Width and height represents the map image size being requested.
| ||
BBOX (Prerequisite: TYPENAME) (Mutually exclusive with FEATUREID, CQL_FILTER, and FILTER) | Bounding box in GML coordinates; used to specify the geographic extent of the results to be returned; see examples below. Note that if a BBOX is supplied, Filter and FEATUREID may NOT be used in the same request. | See Bounding Box (BBOX). | ||
SORTBY | List of propertyName [A,D], where: A=Ascending (default) D=Descending | Specifies a sort order for returned results. | ||
connectId* | Unique 32-digit alphanumeric value provided by Maxar. | Value for this parameter is a unique 32-digit alphanumeric value given by Maxar (see Connect ID). A valid Connect ID is mandatory for every request. | ||
CQL_FILTER (Mutually exclusive with BBOX) | Filter parameters appropriate for the requested Feature type. | |||
showTheRasterReturned | TRUE or FALSE | FALSE is default. If TRUE, then only those Features that are used to fulfill the requested BBOX will be returned. |
*mandatory parameter
Name | Value | Short Description |
---|---|---|
Service* | WFS | Web Feature Service |
Version* | 1.1.0 | Request version |
Request* | DescribeFeatureType | Request name |
typeName | FinishedFeature TileMatrixFeature ImageInMosaicFeature MaxarCatalogMosaicProducts MaxarCatalogMosaicSeamlines MaxarCatalogMosaicTiles | FinishedFeature and ImageInMosaicFeature are applicable to finished products and not for imagery Features. |
outputFormat | text/xml; subtype=gml/3.1.1 | Format to return; if not supplied the default will be returned. gml/3.1.1 is the only format supported at this time and therefore the default. |
connectId* | Unique 32-digit alphanumeric value provided by Maxar | Value for this parameter is a unique 32-digit alphanumeric value given by Maxar (see Connect ID). A valid Connect ID is mandatory for every request. |
*mandatory parameter
The table below displays the response parameters for the DescribeFeatureType request with typename as FinishedFeature.
Element | DataType | Example Value | Example Usage | Description |
---|---|---|---|---|
featureId | string | 17027d713c0c3d9eaef07e80d959e347 | featureId='17027d713c0c3d9eaef07e80d959e347' | A string that uniquely identifies the particular Feature to be included or excluded from returned results. |
geometry | gml:GeometryPropertyType | 34.068123,-96.509471,34.098737,-96.472678 | BBOX(geometry,34.068123,-96.509471,34.098737,-96.472678) | A GML polygon representing the geometry of the Feature instance; the GML includes the Coordinate System of the polygon. |
acquisitionDate | string | 2009-05-27 01:20:43.63599 | acquisitionDate>='2009-05-27 01:20:43.63599' | For source_unit="Strip", the GMT of acquisition of the image used to make the product described by the Feature; for other source_unit values, the GMT of acquisition of the oldest image contained in the product described by the Feature. |
acquisitionTime | int | 1753 | acquisitionTime='1753' | Time of acquisition date in HHMM format |
sensorType | string | Do not include | ||
source | string | WV01 | source='WV01' | The sensor used to collect the imagery used to make the product described by the Feature. |
sourceUnit | string | Strip | sourceUnit='Strip' | The type of product described by the Feature. |
productType | string | Panchromatic | productType='Panchromatic' | The type of product described by the Feature. Pan Sharpened Natural Color Panchromatic |
CE90Accuracy | string | 4.21 | CE90Accuracy<=4.21 | The geographic accuracy of the product described by the Feature, in Meters, as a CE90 value. CE90, Circular Error of 90%, is commonly used for quoting and validating geodetic image registration accuracy. A CE90 value is the minimum diameter of the horizontal circle that can be centered on all photoidentifiable Ground Control Points (GCPs) and also contain 90% of their respective twin counterparts acquired in an independent geodetic survey. |
RMSEAccuracy | string | 7.63 | RMSEAccuracy<=7.63 | The geographic accuracy of the product described by the Feature, in Meters, as a 2d RMS Error value. RMSE, Root Mean Squared Error, is commonly used for quoting and validating geodetic image registration accuracy. A RMSE value is a single summary statistic that describes the square-root of the mean horizontal distance between all photo-identifiable GCPs and their respective twin counterparts acquired in an independent geodetic survey. |
cloudCover | float | 0.5 | cloudCover<=0.5 | The cloud cover percentage of the image used to make the product described by the Feature; this will be 0 for products made from more than one image. |
offNadirAngle | float | 37.6 | offNadirAngle<=37.6 | The off-nadir angle of the image used to create the product described by the Feature; this will be null for products made from more than one image. |
sunElevation | float | 83.5 | sunElevation<=83.5 | The elevation angle of the sun for the image used to make the product described by the Feature; this will be null for products made from more than one image. |
sunAzimuth | float | -117.3 | sunAzimuth>=-117.3 | The azimuth angle of the sun for the image used to make the product described by the Feature; this will be null for products made from more than one image. |
groundSampleDistance | float | 0.5 | groundSampleDistance=0.5 | The GSD of the product described by the Feature. |
groundSampleDistanceUnit | string | Meter | groundSampleDistanceUnit='Meter' | The units of the field groundSampleDistance. |
dataLayer | string | daily_take | dataLayer='daily_take' | Defines the layer in which the product described by the Feature exists.
|
legacyDescription | string | AOI4_L3_WV2 | legacyDescription='AOI4_L3_WV2' | A text description of the product described by the Feature. |
outputMosaic | boolean | TRUE | outputMosaic=TRUE | True if the product described by the Feature consists of multiple images, as in the case of a Region Tile; "False" if the product type is Strip. |
colorBandOrder | string | RGB | colorBandOrder='RGB' | Null for panchromatic data; otherwise the order in which the spectral bands occur in the product described by the Feature. |
assetName | string | FINISHED | assetName='FINISHED' | The Name of the catalog that contains the Product described by the Feature. |
assetType | string | PRODUCT_GEOMETRY | assetType='PRODUCT_GEOMETRY' | The Type of the catalog that contains the Product described by the Feature. |
legacyId | string | 10300100AE766C00 | legacyId='10300100AE766C00' | If source_unit is "Strip", this is the Maxar internal identifier of the image used to make the product described by the Feature; for other source_units, this field is null. |
factoryOrderNumber | string | 052187237-10 | factoryOrderNumber='013291395-10' | The order number that identifies the product described by this Feature within the Maxar internal systems. |
perPixelX | float | 4.50E-06 | perPixelX<=0.0000045 | The pixel size in the x direction; the unit is determined by the "crsFromPixels" value. |
perPixelY | float | 4.50E-06 | perPixelY<=0.0000045 | The pixel size in the y direction; the unit is determined by the "crsFromPixels" value. |
crsFromPixels | string | EPSG:4326 | crsFromPixels='EPSG:4326' | The Coordinate Reference System of the Product described by the Feature. |
url | string | |||
ageDays | int | 14 | ageDays<14 | The age (in days) of the image from today's date. |
formattedDate | string | 2021-06-21 | formattedDate='2021-06-21' | Ingest date without timestamp |
ingestDate | string | 2010-06-21 13:20:43.63599 | ingestDate<='2020-06-21 13:20:43.63599' | The GMT time at which the Feature was made available in SecureWatch. |
spatialAccuracy | string | 1:50,000 | spatialAccuracy='1:50,000' | The accuracy of the product described by the Feature, using the NMAS accuracy scales. National map accuracy standards are specifications of accuracy standards for well-defined map points on published maps that are specified by the U.S. Geological Survey and revised by the U.S. Bureau of the Budget. |
earliestAcquisitionDate | string | 2021-06-28 17:53:56 | earliestAcquisitionDate='2021-06-28 17:53:56' | Earliest date of imagery acquisition |
latestAcquisitionDate | string | 2021-06-28 17:53:56 | latestAcquisitionDate='2021-06-28 17:53:56' | Latest date of imagery acquisition |
pixelsIngested | boolean | true | pixelsIngested=true | |
preciseGeometry | boolean | true | preciseGeometry=true | |
vendorName | string | |||
vendorReference | string | |||
companyName | string | |||
acquisitionType | string | |||
orbitDirection | string | |||
licenseType | string | |||
isBrowse | boolean | false | isBrowse=false | True = Browse, non-native resoultion; False = Native resolution |
isMirrored | boolean | false | isMirrored=false | True = image has been mirrored, False = non-mirrored image |
isMultipleWKB | boolean | false | isMultipleWKB=false | True = multiple objects, False = single object |
copyright | string | |||
beamMode | string | |||
polarisationMode | string | |||
polarisationChannel | string | |||
antennaLookDirection | string | |||
minimumIncidenceAngle | float | |||
maximumIncidenceAngle | float | |||
incidenceAngleVariation | float | |||
niirs | float | 5.1 | niirs>=5.1 | National Imagery Interpretability Rating Scale value |
verticalAccuracy | float | |||
tagsAsString | string |
The table below shows the response parameter for the DescribeFeatureType request with typename as "ImageInMosaicFeature."
Element | Datatype | Example Value | Description |
---|---|---|---|
featureId | String | 17027d713c0c3d9e aef07e80d959e347 | A string that uniquely identifies the particular Feature |
parentFeatureId | String | 17027d713c0c3d9e aef07e80d959e586 | The featureId of the mosaic image that this Feature is associated with. |
geometry | gml:Polygon | BBOX(geometry,34.068123, | A GML polygon representing the geometry of the Feature instance; the GML includes the Coordinate System of the polygon. |
legacyId | String | 10200100077D4A00 | The Maxar system identifier for the image strip described by the Feature. |
source | String | WV01 | The sensor used to collect the imagery used to make the product described by the Feature. |
acquisitionDate | DateTime | 2009-05-27 01:20:43.63599 | The GMT of acquisition of the image described by the Feature. |
cloudCover | Float | 0.32 | The cloud cover percentage of the image described by the Feature. |
offNadirAngle | Float | 20.0 | The average off-nadir angle of the image strip described by the Feature. |
sunElevation | Float | 0.0-90.0 or null | The elevation angle of the sun for the image strip described by the Feature. |
sunAzimuth | Float | +/- 180.00 or null | The azimuth angle of the sun for the image strip described by the Feature. |
createdContentIdentifier | String | 2000037383009 | The Maxar catalog identifier of the mosaic product with which this Feature is associated. |
The table below shows the response parameter for the DescribeFeatureType request with typename as "MaxarCatalogMosaicProducts."
Element | DataType | ExampleValue | Example Usage | Description |
---|---|---|---|---|
shape | gml:MultiSurfacePropertyType | 39.7530,-104.9962,39.7580,-104.9912 | BBOX=39.7530,-104.9962,39.7580,-104.991 | A GML polygon representing the geometry of the Catalog Mosaic instance; the GML includes the Coordinate System of the polygon. |
product_name | string | VIVID_NA25_20Q2 | PRODUCT_NAME='VIVID_NA25_20Q2' | Catalog identifier for the product |
product_line_name | string | Vivid 2.0 | PRODUCT_LINE_NAME='Vivid 2.0' | Product Line Name
|
collect_date_min | dateTime | 2004-08-24 | COLLECT_DATE_MIN='2004-08-24' | Minimum image date of the collection |
collect_date_max | dateTime | 2020-03-30 | COLLECT_DATE_MAX='2020-03-30' | Maximum image date of the collection |
product_id | string | VIVID_NA25_20Q2 | PRODUCT_ID='VIVID_NA25_20Q2' | Catalog identifier for the product |
publish_date | dateTime | 2020-09-25 | PUBLISH_DATE>='2020-09-25' | Date published |
resolution_meters | decimal | 0.5 | RESOLUTION_METERS<=0.5 | Image resolution |
The table below shows the response parameter for the DescribeFeatureType request with typename as "MaxarCatalogMosaicSeamlines."
Element | DataType | ExampleValue | Example Usage | Description |
---|---|---|---|---|
shape | gml:MultiSurfacePropertyType | 39.7530,-104.9962,39.7580,-104.9912 | BBOX=39.7530,-104.9962,39.7580,-104.991 | A GML polygon representing the geometry of the Catalog Mosaic instance; the GML includes the Coordinate System of the polygon. |
image_identifier | string | 105001001C136600 | IMAGE_IDENTIFIER='105001001C136600' | This is the Maxar internal identifier of the image used to make the product described by the Feature |
off_nadir_angle | float | 21.181688 | OFF_NADIR_ANGLE=21.181688 | The off-nadir angle of the image used to create the product described by the Feature; this will be null for products made from more than one image. |
cloud_cover | float | 0.00 | CLOUD_COVER=0.00 | The cloud cover percentage of the image used to make the product described by the internal identifier of the image |
sun_elevation | float | 46.34113300 | SUN_ELEVATION=46.34113300 | The elevation angle of the sun for the image used to make the product described by the Feature; this will be null for products made from more than one image. |
vehicle_id | string | GE01 | VEHICLE_ID='GE01' | The sensor used to collect the imagery used to make the product described by the image identifier. |
collect_date | datetime | 2020-03-18T17:52:49Z | COLLECT_DATE='2020-03-18T17:52:49Z' | Collection date of the image used in making the seamline |
product_id | string | BBA_BGRN_VIVID_NA25_20Q2 | PRODUCT_ID='BBA_BGRN_VIVID_NA25_20Q2' | Catalog identifier for the product |
product_line_name | string | Vivid 3.0 | PRODUCT_LINE_NAME='Vivid 3.0' | Product Line Name
|
The table below shows the response parameter for the DescribeFeatureType request with typename as "MaxarCatalogMosaicTiles."
Element | DataType | ExampleValue | Example Usage | Description |
---|---|---|---|---|
shape | gml:MultiSurfacePropertyType | 39.7530,-104.9962,39.7580,-104.9912 | BBOX=39.7530,-104.9962,39.7580,-104.991 | A GML polygon representing the geometry of the Catalog Mosaic instance; the GML includes the Coordinate System of the polygon. |
product_id | string | VIVID2_AF01_18Q4 | Catalog identifier for the product | |
cloud_cover_percentage | float | 0 | CLOUD_COVER_PERCENTAGE=0 | The cloud cover percentage of the image used to make the product described by the catalog identifier |