API Migration Guide from 1.0 to 2.0

1 API 1.0 to 2.0 Layer Translations:
2 API 1.0 to 2.0 Services Translations
- 2.1 Administrative Services
- 2.2 Coverage Services
- 2.3 Discrete and Static Imagery Services
- 2.4 Elements Services
- 2.5 Metadata Services
- 2.6 Tile Services

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

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

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		`https://api.vexcelgroup.com/v2/auth/verify?username={username}&password={password}`
	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

API 1.0 Service	API 1.0 Parameter	API 2.0 Service	API 2.0 Parameter	Notes	examples
//metadata/CoverageDataInPoint		//oriented/collections¹			`https://api.vexcelgroup.com/v2/oriented/collections?token={token}`
	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			`https://api.vexcelgroup.com/v2/dsm/collections?token={token}`
	token		token		Roma, Italy - Demonstrating `wkt`, `spatial-operation`, and `metadata-format`: `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 `collection`, and `include`: `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			`https://api.vexcelgroup.com/v2/dtm/collections?token={token}`
	token		token		Manitowoc, WI - Demonstrating `collection`, and `include`: `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 `wkt` , `spatial-operation`, and `metadata-format`: `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/collections¹			`https://api.vexcelgroup.com/v2/oriented/collections?token={token}`
	wkt		wkt		Suburban Mobile Alabama - Demonstrating `wkt=polygon,` `srid` `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 `wkt=point`, `layer`, `collect-year`, and `metadata-format=csv` `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 `format=json`, `srid` `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/collections¹			`https://api.vexcelgroup.com/v2/oriented/collections`
	token		token		St. Louis, MO - Demonstrating `collection`, `srid`, and `include`: `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 `layer`: `https://api.vexcelgroup.com/v2/oriented/collections?layer=graysky&token={token}`
	orientation		orientation		Green Bay, Wisconsin - Demonstrating `wkt` and `format`: `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