Introduction

Vexcel’s Ortho imagery is generated by combining many overlapping images and as such it is impossible to know the exact date of collection for a given location. This service will query a point for overlapping nadir images and return the minimum, maximum and estimated date for each pixel.

Minimum - The earliest date of collection for any intersecting nadir image matching the query criteria
Maximum - The latest date of collection for any intersecting nadir image matching the query criteria
Estimated - The collection date of the nadir image most centered over the input location and matching the query criteria

Base URL

https://api.gic.org/metadata/OrthoEstimateDates

Parameters

Parameter	Parameter Type	Data Type	Description	Example Format	Notes

Parameter	Parameter Type	Data Type	Description	Example Format	Notes
Mandatory:
`layer`	Ordered Rest (1st) - or - Key Value Pair (KVP)	String	The name of the layer. `bluesky-ultra-g` 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 Osprey (7.5 GSD) `bluesky-high` Wide area data collected with Condor (15-20cm GSD) `bluesky-high-europe` Wide area data collected with Condor in Europe (15-20cm GSD) `graysky-g` Gray Sky events collected by Geomni `graysky` Gray Sky events collected with Ultracam sensors	`/bluesky-ultra` or `layer=bluesky-ultra`
`wkt`	Key Value Pair	String	The “well-known text” field defines the point to search for collection dates.	`wkt=POINT(-83.99399755 36.04708649)`
Optional:
`year`	Key Value Pair	Integer ($int32)	The collection year of the intersecting images expressed with 4 digits (e.g. 2021 or 2018). If `year` is omitted, the most recent information across all available years will be returned.
`startDate`	Key Value Pair	String ($date-time)	No images collected prior to this date will be considered when querying for intersecting nadir images.		Format: ISO 8601 ("yyyy-MM-dd'T'HH:mm:ss")
`endDate`	Key Value Pair	String ($date-time)	No images collected after this date will be considered when querying for intersecting nadir images.		Format: ISO 8601 ("yyyy-MM-dd'T'HH:mm:ss")
`aoi`	Key Value Pair	String	The identifier of the Area of Interest (AOI) which contains the desired imagery.	`AOI=` bluesky-ultra-g: `aoi=us-al-tuscaloosa_leica-2020` bluesky-ultra: `aoi=us-az-avondale-2021` bluesky-ultra-europe: `aoi=it-62-rome-2020` bluesky-ultra-oceania: `aoi=au-qld-sunshinecoast-2019` bluesky-ultra-japan: `aoi=jp-20-matsumoto-2022` urban-r: `aoi=us-ok-oklahomacity_rf01-2023` bluesky-high: `aoi=USUSCON2001` bluesky-high-europe: `aoi=EUEUCON2201` graysky-g: `aoi=USAZSTR1805` graysky: `aoi=us-la-neworleans-tornado-2022`	The available `AOI`(s) for a point or polygon can be determined using the OrthoCoverage service.
`childAOI`	Key Value Pair	String	The identifier of the child Area of Interest (AOI) which contains the desired imagery. For bluesky-ultra AOIs, the `ChildAOI` will match the AOI name. This parameter can be especially useful for Gray Sky events.	`ChildAOI=` bluesky-ultra-g: `ChildAOI=us-al-tuscaloosa_leica-2020` bluesky-ultra: `ChildAOI=us-az-avondale-2021` bluesky-ultra-europe: `ChildAOI=it-62-rome-2020` bluesky-ultra-oceania: `ChildAOI=au-qld-sunshinecoast-2019` bluesky-ultra-japan: `ChildAOI=jp-20-matsumoto-2022` urban-r: `ChildAOI=us-ok-oklahomacity_rf01-2023` bluesky-high: `ChildAOI=n33w87-us-al-tuscaloosa-2019` bluesky-high-europe: `ChildAOI=n53e14-de-bb-templin-2022` graysky-g: `ChildAOI=190226/USMSCOLDMC` graysky: `ChildAOI=graydata-363`

Examples

Knoxville, Tennessee, USA - Mandatory Parameters
https://api.gic.org/metadata/OrthoEstimateDates/bluesky-ultra?wkt=POINT(-83.99399755 36.04708649)

Parameter	Value

Parameter	Value
`layer`	`bluesky-ultra`
`wkt`	`POINT(-83.99399755 36.04708649)`

{
"child_aoi": "us-tn-knoxville-2022",
"estimate_date": "2022-05-10 16:04:49",
"min_capture_date": "2022-05-05 13:43:28",
"max_capture_date": "2022-05-20 14:23:24"
}

________________________________________________________________________________________

Melbourne, Victoria, Australia - Demonstrating childAOI
https://api.gic.org/metadata/OrthoEstimateDates/bluesky-ultra-oceania?wkt=POINT(145.133565 -37.913311)&childAOI=au-vic-moorabbin-2020

Parameter	Value

Parameter	Value
`layer`	`bluesky-ultra-oceania`
`wkt`	`POINT(145.133565 -37.913311)`
`childAOI`	`au-vic-moorabbin-2020`

{
"child_aoi": "au-vic-moorabbin-2020",
"estimate_date": "2020-11-08 05:15:20",
"min_capture_date": "2020-03-31 01:51:21",
"max_capture_date": "2020-11-17 22:35:18"
}

Vexcel API Documentation

OrthoEstimateDates - v1.4

Introduction

Base URL

Parameters

Examples