CoverageDataInPoint Service - v1.4


Introduction

The CoverageDataInPoint service will take a layer and lat/lon coordinates and return the earliest and latest collection date and ground sample distance (pixel size) of all intersecting discrete images. This service is useful to determine the full date range of available images over a given point.

 

Similar functionality can be achieved by using the more robust FindImageInPoint service which will identify discrete images intersecting the input coordinate and provide both collection dates and GSD (amongst all metadata attributes) all while searching one or more layers.


Technical Details

 This service requires a point (lat/lon coordinates) and the desired imagery layer. It will return a JSON file containing the earliest capture date, latest capture date and ground sample distance (GSD).

Output File Specifications:

  • JSON file


Base URL

This service will answer to requests on the following URL:
https://api.gic.org/metadata/CoverageDataInPoint?layer={layer}&lat={lat}&lon={lon}&token={token}


Parameters

Parameter

Parameter Type

Data Type

Description

Example Format

Notes

Parameter

Parameter Type

Data Type

Description

Example Format

Notes

Mandatory:

layer

Key Value Pair (KVP)

 string

 The name of the layer in which to search for coverage.

bluesky-ultra-g (default)

Urban data collected by Geomni (7.5 GSD)

bluesky-ultra
Urban data collected with Osprey (7.5cm GSD)

bluesky-ultra-europe
Urban data collected with Osprey in Europe (7.5 GSD)

bluesky-ultra-oceania
Urban data collected with Osprey in Oceania (7.5 GSD)

bluesky-ultra-japan

Urban data collected with Osprey in Japan (7.5 GSD)

urban-r

Urban data collected with Condor (7.5 GSD)

bluesky-high
Wide area data collected with Condor in North America (15cm GSD)

bluesky-high-europe
Wide area data collected with Condor in Europe (15cm GSD)

graysky-g
Gray Sky events collected by Geomni

graysky
Gray Sky events collected with Ultracam sensors

 layer=bluesky-ultra-g

 

lat

Key Value Pair

double

The degrees of latitude defining the point.

lat=40.80758574076

 

lon

Key Value Pair

double

The degrees of longitude defining the point.

lon=-74.010414025893

 

token

Key Value Pair

string

The token used to authenticate the requests.

token={token}

Use the Authenticate Service to receive a token.


Example

Indoor Ski Resort, East Rutherford, New Jersey - Demonstrating CoverageDataInPoint service
https://api.gic.org/metadata/CoverageDataInPoint?layer=bluesky-ultra-g&lat=40.81047113801408&lon=-74.0701853718421&token={token}

Results: {"min_date":"2016-05-20","max_date":"2016-08-23","gsd":0.08546422}

Parameter

Value

Parameter

Value

layer

bluesky-ultra-g

lat

40.81047113801408

lon

-74.0701853718421

token

{token}

Point Location:


Need help? Create a support ticket | support@vexcelgroup.com