Skip to main content
Skip table of contents

Streaming API

The HxGN Content Program offers secure streaming access to an extensive library of high-resolution aerial orthoimagery. The streaming service uses Open Geospatial Consortium (OGC) compliant Web Map Service (WMS) and Web Map Tile Service (WMTS) protocols according to the specifications on the OGC website.

The following streaming protocols are provided for all desktop and web applications:

Service

URL

Authentication Supported

WMS

https://services.hxgncontent.com/streaming/wms?

  • Basic (username/password)

  • OAuth (client credentials grant)

WMTS

https://services.hxgncontent.com/streaming/wmts?

  • Basic (username/password)

  • OAuth (client credentials grant)

ArcGIS REST/SOAP

https://services.hxgncontent.com/streaming/rest/services/

  • Basic (username/password)

Access to the streaming service is provided using unsecured (HTTP) and secured (HTTPS) protocols. If your application requires a secured protocol connection, simply insert HTTPS in place of HTTP into all web addresses listed throughout this guide.

Please note: HTTP will always perform faster than HTTPS, which is largely based on the end client and its support of the connection. As such, HTTPS should only be used when necessary (e.g. ArcGIS online connections).

The HxGN Content Program streaming service supports multiple types of requests:

  1. Small real time requests: < 3500 x 3500 pixels served instantly for desktop and web applications

  2. Large real time requests: < 15k x 15k pixels (called "plots") put into a queue and served with a lower priority. (Note: requests larger than 15k dimension will be downsampled to 15k pixels).

  3. Large asynchronous requests using shapefile/GeoJSON file: custom end points for integration with other client like web stores.

 

Below are examples of how to access the streaming service and use features that are supported via WMS:

The streaming service supports the following WMS parameters:

  • REQUEST: GetCapabilities and GetMap

  • SRS: projection code in which the image is to be returned (EPSG codes)

  • BBOX: Bounding box of the image request

  • FORMAT: Format the image is to be returned

  • WIDTH: Width in pixels of the image

  • HEIGHT: Height in pixels of the image

  • LAYERS: Image layer requested

  • STYLES (optional): Used in sorting data within a mosaic, for example, STYLES=BRD would sort data by color (over B&W), resolution, and image date STYLES=TIMESTAMP will timestamp the image with the acquisition date of the layer.

Default setting to be used for best performing integration:

  • Protocol: WMTS

  • URL: https://services.hxgncontent.com/streaming/wmts?

  • Layer: “HxGN_Imagery"

  • Format: *.xxx ("image/unknown", Can also use *.jpg for simplicity if the client side mapping SDK does support mixed image formats)

  • Projection: EPSG:3857 (Google Web Mercator)

Metadata

The streaming service supports GetFeatureInfo from the OGC-compliant WMS and WMTS specifications to provide detailed information for each pixel.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.

Contact Support Close