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

JSON vs JSONP: https://en.wikipedia.org/wiki/JSONP

Vexcel API Documentation

FindImagesInPoint Service - v1.4

Introduction

Technical Details

Base URL

Parameters

Examples

See Also

External Resources