FindImagesInPoint Service - v1.4

Owned by Scott Jonker
Feb 26, 2024
38 min read

Introduction

FindImagesInPoint will take lat/long coordinates and identify all available nadir and oblique discrete images available for that point. The output is a metadata file with information about each discrete image. This service is available for all layers in the Vexcel library.

Technical Details

The output metadata can be provided in three formats, xml, json or jsonp.

Output Specifications:

  • Metadata Formats (xml, json, jsonp)

Detailed information about the metadata can be found in Discrete Image Metadata.

Base URL

This service responds to requests from following URLs:

  • Mandatory parameters only - Defined as ordered http REST parameters:
    https://api.gic.org/metadata/FindImagesInPoint/{format}/{EPSG}/{wkt}?token={token}

  • Mandatory parameters only - Defined as Key Value Pairs:
    https://api.gic.org/metadata/FindImagesInPoint?format={format}&EPSG={EPSG}&wkt={wkt}&token={token}

  • All parameters - Defined as a mix of REST and Key Value Pairs:
    https://api.gic.org/metadata/FindImagesInPoint/{format}/{EPSG}/{wkt}?orientation={orientation}&rendering={rendering}&layer={layer}&jsonpFunction={jsonpFunction}&token={token}

Parameters

Parameter

Parameter Type

Data Type

Description

Format

Notes

Parameter

Parameter Type

Data Type

Description

Format

Notes

Mandatory:

format

Ordered REST (1st) - or - Key Value Pair (KVP)

String

Format of the response.

xml - Extensible Markup Language

json - JavaScript Object Notation

jsonp - JavaScript Object Notation with Padding

Ordered REST: /xml
KVP: format=xml

The jsonp padding can be defined with the use of the jsonFunction parameter.

EPSG

Ordered REST (2nd) - or - Key Value Pair (KVP)

Integer

The EPSG code for the projection reference representing the coordinates of the given WKT (below).

Ordered REST: /4623
KVP: EPSG=4623

 

wkt

Ordered REST (3rd) - or - Key Value Pair (KVP)

String

The well-known-text (WKT) representation of the requested point.

Ordered REST: /POINT(-78.702694 35.809537)
KVP: wkt=POINT(-78.702694 35.809537)

 

token

Key Value Pair

String

The token used to authenticate the requests.

token={token}

Use the Authenticate Service to receive a token.

Optional:

orientation

Ordered REST (4th) - or - Key Value Pair

String

The camera-axis and/or cardinal orientation of the images to be delivered.

ALL: all orientations

NADIR: all the Nadir orientations (NN, NS, NE, NW)

OBLIQUE: all the oblique orientations: (N, S, E, W)

Single values for specific orientations:   N, S, E, W, NN, NS, NE, NW, I

orientation=NADIR

 

rendering

Key Value Pair

String

The color band rendering of the image metadata.

all - Default - Metadata is received from all available images

rgb - Metadata is received only for rgb (red, green, blue) images: including both nadir and oblique.

nir - Metadata is received only for Near-infrared images. Infrared is only available in nadir images from layers bluesky-high, bluesky-ultra and graysky.

rendering=all

 

layer

Key Value Pair

String

The layer(s) with which to search for coverage over the input point. To specify more than one layer, the values must be separated by commas.

bluesky-ultra-g (default )
Urban data collected by Geomni in North America (7.5 GSD)

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

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

bluesky-ultra-oceania
Urban data collecgted 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 in North America

graysky
Gray Sky events collected with Ultracam sensors in North America

layer=bluesky-high

jsonpFunction

Key Value Pair

String

The customizable name of the padding function for format=jsonp calls. If left undefined, the default name is VexcelFunction.

jsonpFunction={CustomName}

Examples

Suburban Neighborhood - Raleigh/Durham, North Carolina - Demonstrating orientation and format=xml
https://api.gic.org/metadata/FindImagesInPoint/xml/4326/POINT(-78.837 35.822)/nw?token={token}

Table of Parameters:

Parameter

Value

Parameter

Value

format

xml

epsg

4326

wkt

POINT(-78.837 35.822)

orientation

nw

token

{token}

Metadata Output Sample:

<?xml version="1.0" encoding="UTF-8"?> <Images> <images> <DiscreteImageMetadataDTO> <child_aoi>us-nc-raleigh_leica-2019</child_aoi> <centre_wkt>POINT(-78.836291 35.82284701)</centre_wkt> <relationPolygonInImage>0.0</relationPolygonInImage> <processing_toolset_version>3.3.0</processing_toolset_version> <layername>bluesky-ultra-g</layername> <bbox_wkt>POLYGON((-78.83835225 35.82062885,-78.83834245 35.82507432,-78.83420361 35.82509296,-78.83423709 35.82061706,-78.83835225 35.82062885))</bbox_wkt> <flight_line_id>0249</flight_line_id> <b1>0.0</b1> <b2>0.0</b2> . . .
<?xml version="1.0" encoding="UTF-8"?> <Images> <images> <DiscreteImageMetadataDTO> <child_aoi>us-nc-raleigh_leica-2019</child_aoi> <centre_wkt>POINT(-78.836291 35.82284701)</centre_wkt> <relationPolygonInImage>0.0</relationPolygonInImage> <processing_toolset_version>3.3.0</processing_toolset_version> <layername>bluesky-ultra-g</layername> <bbox_wkt>POLYGON((-78.83835225 35.82062885,-78.83834245 35.82507432,-78.83420361 35.82509296,-78.83423709 35.82061706,-78.83835225 35.82062885))</bbox_wkt> <flight_line_id>0249</flight_line_id> <b1>0.0</b1> <b2>0.0</b2> <id>641519434</id> <max_zoom>0</max_zoom> <projectname>us-nc-raleigh_leica-2019</projectname> <k0>0.0</k0> <cameratechnology>LEICA</cameratechnology> <k1>0.0</k1> <k2>0.0</k2> <camera_pos_y>3966460.194</camera_pos_y> <k3>0.0</k3> <original_shot_id>001_0249_00002482</original_shot_id> <utm_zone>17N</utm_zone> <omega>4.78E-4</omega> <camera_pos_x>695458.948</camera_pos_x> <copyrightsentence>VEXCEL</copyrightsentence> <calibration_date/> <capture_date>2019-01-16T18:24:35</capture_date> <image_id>2019~us-nc-raleigh_leica-2019~images~NW_20190116_182435_54_3835DDA8B2ECC8F_rgb</image_id> <raster_size_width>10336.0</raster_size_width> <p1>0.0</p1> <p2>0.0</p2> <focal_length>83.0</focal_length> <dtmfile/> <tile_size_x>256</tile_size_x> <bbox_wkt_latlon>POLYGON((-78.83835225 35.82062885,-78.83834245 35.82507432,-78.83420361 35.82509296,-78.83423709 35.82061706,-78.83835225 35.82062885))</bbox_wkt_latlon> <pixel_size>0.0052</pixel_size> <centre_wkt_latlon>POINT(-78.836291 35.82284701)</centre_wkt_latlon> <tile_size_y>256</tile_size_y> <min_zoom>3</min_zoom> <kappa>-4.692425</kappa> <camera_name>04P2_JPEG_NONROTATED_CAM1_DOWN</camera_name> <orientation>NW</orientation> <raster_size_height>7788.0</raster_size_height> <processing_date>2021-09-17T06:20:33</processing_date> <original_image_name>2019/38/35/DD/A8/NW_20190116_182435_3835DDA8B2ECC8F.amf</original_image_name> <ground_z>99.9929428100586</ground_z> <phi>-0.001277</phi> <pp0_x>0.0</pp0_x> <camera_z>863.0469970703125</camera_z> <externalAoiId/> <pp0_y>0.0</pp0_y> <requested_point_wkt/> <gsd>0.04780583514969751</gsd> <aoi>us-nc-raleigh_leica-2019</aoi> <processingcenter/> <projectext>us-nc-raleigh_leica-2019</projectext> <relationImageInPolygon>0.0</relationImageInPolygon> </DiscreteImageMetadataDTO> <DiscreteImageMetadataDTO> <child_aoi>us-nc-raleigh_leica-2019</child_aoi> <centre_wkt>POINT(-78.83787317 35.82285268)</centre_wkt> <relationPolygonInImage>0.0</relationPolygonInImage> <processing_toolset_version>3.3.0</processing_toolset_version> <layername>bluesky-ultra-g</layername> <bbox_wkt>POLYGON((-78.83993945 35.82062943,-78.83992655 35.82508255,-78.83578529 35.82509872,-78.8358165 35.82061945,-78.83993945 35.82062943))</bbox_wkt> <flight_line_id>0249</flight_line_id> <b1>0.0</b1> <b2>0.0</b2> <id>641519438</id> <max_zoom>0</max_zoom> <projectname>us-nc-raleigh_leica-2019</projectname> <k0>0.0</k0> <cameratechnology>LEICA</cameratechnology> <k1>0.0</k1> <k2>0.0</k2> <camera_pos_y>3966457.577</camera_pos_y> <k3>0.0</k3> <original_shot_id>001_0249_00002483</original_shot_id> <utm_zone>17N</utm_zone> <omega>5.93E-4</omega> <camera_pos_x>695315.967</camera_pos_x> <copyrightsentence>VEXCEL</copyrightsentence> <calibration_date/> <capture_date>2019-01-16T18:24:37</capture_date> <image_id>2019~us-nc-raleigh_leica-2019~images~NW_20190116_182437_54_3835DDA8A2A8738_rgb</image_id> <raster_size_width>10336.0</raster_size_width> <p1>0.0</p1> <p2>0.0</p2> <focal_length>83.0</focal_length> <dtmfile/> <tile_size_x>256</tile_size_x> <bbox_wkt_latlon>POLYGON((-78.83993945 35.82062943,-78.83992655 35.82508255,-78.83578529 35.82509872,-78.8358165 35.82061945,-78.83993945 35.82062943))</bbox_wkt_latlon> <pixel_size>0.0052</pixel_size> <centre_wkt_latlon>POINT(-78.83787317 35.82285268)</centre_wkt_latlon> <tile_size_y>256</tile_size_y> <min_zoom>3</min_zoom> <kappa>-4.692524</kappa> <camera_name>04P2_JPEG_NONROTATED_CAM1_DOWN</camera_name> <orientation>NW</orientation> <raster_size_height>7788.0</raster_size_height> <processing_date>2021-09-17T06:20:26</processing_date> <original_image_name>2019/38/35/DD/A8/NW_20190116_182437_3835DDA8A2A8738.amf</original_image_name> <ground_z>99.35977172851562</ground_z> <phi>-0.001309</phi> <pp0_x>0.0</pp0_x> <camera_z>862.5120239257812</camera_z> <externalAoiId/> <pp0_y>0.0</pp0_y> <requested_point_wkt/> <gsd>0.04781198929289286</gsd> <aoi>us-nc-raleigh_leica-2019</aoi> <processingcenter/> <projectext>us-nc-raleigh_leica-2019</projectext> <relationImageInPolygon>0.0</relationImageInPolygon> </DiscreteImageMetadataDTO> </images> </Images>

 

________________________________________________________________________________________

The North Carolina Museum of Art - Raleigh, North Carolina - Demonstrating rendering, jsonpFunction and format=jsonp
https://api.gic.org/metadata/FindImagesInPoint/jsonp/4326/POINT(-78.702694 35.809537)?rendering=rgb&jsonpFunction=samplename&token={token}

Table of Parameters:

Parameter

Value

Parameter

Value

format

jsonp

epsg

4326

wkt

POINT(-78.702694 35.809537)

rendering

rgb

jsonpFunction

samplename

token

{token}

Metadata Output Sample:

function samplename() {return [ { "child_aoi": "us-nc-raleigh_leica-2019", "centre_wkt": "POINT(-78.70378631 35.81182468)", "relationPolygonInImage": 0, "processing_toolset_version": "3.3.0", "layername": "bluesky-ultra-g", "bbox_wkt": "POLYGON((-78.70203364 35.80910013,-78.70548187 35.80930301,-78.7049989 35.81373408,-78.70256962 35.81367997,-78.70203364 35.80910013))", "flight_line_id": "0247", "b1": 0, "b2": 0, "id": 641704372, . . .

________________________________________________________________________________________

Eno River Bridge - Eno River State Park - Durham, North Carolina - Demonstrating layer and format=json
https://api.gic.org/metadata/FindImagesInPoint/json/4326/POINT(-79.007711 36.075451)?&layer=bluesky-ultra-g&token={token}

Table of Parameters:

Parameter

Value

Parameter

Value

format

json

espg

4326

wkt

POINT(-79.007711 36.075451)

layer

bluesky-ultra-g

token

{token}

Metadata Output Sample:

External Resources

 

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