API Migration Guide from 1.0 to 2.0
API 2.0 documentation is located here: https://api.vexcelgroup.com/v2/
Try out our code samples: https://gicapps.azurewebsites.net/static/
API 1.0 to 2.0 Layer Translations:
API 1.0 | API 2.0 | Layer Description | Imagery Types |
|---|---|---|---|
bluesky-ultra-g | urban-g | Urban data collected by Geomni | Ortho, Oriented |
bluesky-ultra | urban | Urban data collected with Osprey (7.5cm GSD) | Ortho, Oriented |
bluesky-ultra-oceania | urban | Urban data collected with Osprey (7.5cm GSD) | Ortho, Oriented |
bluesky-ultra-europe | urban | Urban data collected with Osprey (7.5cm GSD) | Ortho, Oriented |
bluesky-ultra-japan | urban | Urban data collected with Osprey (7.5cm GSD) | Ortho, Oriented |
urban-r | urban-r | Urban data collected with Condor (7.5cm GSD) | Ortho |
bluesky-high | wide-area | Wide area data collected with Condor (15cm GSD) | Ortho |
bluesky-high-europe | wide-area | Wide area data collected with Condor (15cm GSD) | Ortho |
graysky | graysky | Gray Sky data collected by UltraCam sensors. | Ortho or ortho/oriented (Depends on camera used) |
graysky-g | graysky-g | Gray Sky data collected by Geomni | Ortho or ortho/oriented (Depends on camera used) |
API 1.0 to 2.0 Services Translations
Dark Green Fill = Required
Dark Yellow Fill = Optional
Administrative Services
API 1.0 Service | API 1.0 Parameter | API 2.0 Service | API 2.0 Parameter | Notes | examples |
|---|---|---|---|---|---|
//auth/Login |
| //auth/login |
| The new auth system will create 24h tokens and not save them because they are auto-verified |
|
| username |
| username |
|
|
| password |
| password |
|
|
//auth/Logout |
| Removed |
|
|
|
| token |
| no correlated 2.0 Service |
|
|
//auth/Authenticate |
| //auth/verify |
|
|
|
| token |
| token |
|
|
| format |
| no correlated 2.0 parameter |
|
|
| jsonpFunction |
| no correlated 2.0 parameter |
|
|
Coverage Services
API 1.0 Service | API 1.0 Parameter | API 2.0 Service | API 2.0 Parameter | Notes | examples |
|---|---|---|---|---|---|
//metadata/CoverageDataInPoint |
| //oriented/collections1 |
|
|
|
| layer |
| layer |
| Indoor Ski Resort, East Rutherford, New Jersey - Demonstrating CoverageDataInPoint service https://api.vexcelgroup.com/v2/oriented/collections?wkt=POINT(-74.0701853718421 40.81047113801408)&srid=4326&layer=urban-g&token={token} |
| lat |
| wkt |
|
|
| lon |
| wkt |
|
|
| token |
| token |
|
|
//metadata/DSMCoverage |
| //dsm/collections |
|
|
|
| token |
| token |
| Roma, Italy - Demonstrating https://api.vexcelgroup.com/v2/dsm/collections?wkt=POINT(12.4920256 41.8897457)&srid=4326&spatial-operation=INTERSECT&layer=urban,urban-g&metadata-format=JSON&order-by=default&token={token} |
| layer |
| layer |
| Texas City, TX - Demonstrating https://api.vexcelgroup.com/v2/dsm/collections?collection=us-tx-pearland-2021&metadata-format=JSON&include=layer,first-capture-date,last-capture-date,min-gsd,max-gsd&order-by=default&token={token} |
| aoi |
| no correlated 2.0 parameter |
|
|
| ChildAOI |
| collection |
|
|
| wkt |
| wkt |
|
|
| EPSG |
| srid |
|
|
| include |
| include |
|
|
| skip |
| include | won’t return anything if the include parameter is empty, will only return what you specify when using the include parameter |
|
| format |
| metadata-format |
|
|
//metadata/DTMCoverage |
| //dtm/collections |
|
|
|
| token |
| token |
| Manitowoc, WI - Demonstrating https://api.vexcelgroup.com/v2/dtm/collections?srid=4326&collection=n44w87-us-wi-manitowoc-2022&metadata-format=JSON&include=first-capture-date,last-capture-date,min-gsd,max-gsd&token={token} |
| layer |
| layer |
| Roma, Italy - Demonstrating https://api.vexcelgroup.com/v2/dtm/collections?wkt=POINT(12.4920256 41.8897457)&srid=4326&spatial-operation=INTERSECT&layer=urban, urban-g&metadata-format=JSON&order-by=default&token={token} |
| aoi |
| no correlated 2.0 parameter |
|
|
| childAOI |
| collection |
|
|
| wkt |
| wkt |
|
|
| EPSG |
| srid |
|
|
| include |
| include |
|
|
| skip |
| include | won’t return anything if the include parameter is empty, will only return what you specify when using the include parameter |
|
| format |
| metadata-format |
|
|
//metadata/GetCoverageInfo |
| //oriented/collections1 |
|
|
|
| wkt |
| wkt |
| Suburban Mobile Alabama - Demonstrating https://api.vexcelgroup.com/v2/oriented/collections?wkt=POLYGON((-88.268531 30.704939, -88.264239 30.704939, -88.264239 30.700806,-88.268531 30.700806, -88.268531 30.704939))&srid=4326&token={token} |
| token |
| token |
| Port of Pensacola, Pensacola Florida - Demonstrating https://api.vexcelgroup.com/v2/oriented/collections?wkt=POINT(-87.209520 30.404678)&layer=urban,wide-area&collect-year=2022&metadata-format=CSV&token={token} |
| layers |
| layer |
| Hard Rock Casino, Biloxi Mississippi - Demonstrating https://api.vexcelgroup.com/v2/oriented/collections?wkt=POINT(-88.887932 30.392263)&metadata-format=json&srid=4326&token={token} |
| format |
| metadata-format |
|
|
| epsg |
| srid |
|
|
| jsonpFunction |
| no correlated 2.0 parameter |
|
|
//metadata/ImageLayerCoverage |
| //oriented/collections1 |
|
|
|
| token |
| token |
| St. Louis, MO - Demonstrating https://api.vexcelgroup.com/v2/oriented/collections?srid=32615&collection=us-mo-stlouis-2022&include=min-gsd,max-gsd&order-by=default&token={token} |
| layer |
| layer |
| Graysky collection - Demonstrating |
| orientation |
| orientation |
| Green Bay, Wisconsin - Demonstrating https://api.vexcelgroup.com/v2/oriented/collections?wkt=POLYGON((-88.13334998269332 44.56837029609595,-87.90538367409957 44.56837029609595,-87.90538367409957 44.429278530221296,-88.13334998269332 44.429278530221296,-88.13334998269332 44.56837029609595))&format=wkt&token={token} |
| aoi |
| no correlated 2.0 parameter |
|
|