Atlas GIS Reverse Geo-code Service
This document defines the process of executing a route request and the description of the XML response.
The HTTP GET request contains the address or coordinates of the route origin (start point) and the address or coordinates of the route destination (end point). The response will contain a route description for the requested route, defining all required maneuvers (turns, bears etc.) and the points on route to draw it on the map. In case the origin (or destination) address were not found, the status and status string under the <status> tag will describe the status result. In that case, there might be several options to choose from (several matching addresses) or none. In both cases no route will be returned and the <maneuvers> tag will be empty. If so, the user should choose one of the given options or refine the addresses, then resend a route request.
Example:
Request:
http://gis.global.atlasct.com/gis/routing?key=KEY&countrycode=usa&lang=&q0=801+west+end+new+york+ny&c0=&q1=W+96TH+st+new+york+ny&routeType=fastest&projection=latlong&slim=true&output=kml&api=3.0&ie=utf-8
Response:
{
"Status":{
"Code":1,
"Name":"Successful"
},
"Placemark":[
{
"address":"801 West End Ave, New York, NY 10025",
"ExtendedData":{
"fromHouseNumber":"801",
"fromLookUp":"false",
"realHouseNumber":"true",
"drivingDirection":"-1",
"addressTypeId":"1000",
"hasBarrier":"false",
"addressId":"26165562",
"toHouseNumber":"819"
},
"AddressDetails":{
"Status":{
"Code":1,
"Name":"Successful"
},
"Accuracy":1,
"HouseNumber":801,
"ZoomLevel":0,
"ZipCode":10025,
"Street":"West End Ave",
"Country":{
"Code":"usa",
"Name":"USA"
},
"AdminAreas":{
"L1":{
"localName":"city",
"like":"City",
"display":true,
"content":"New York"
},
"L2":{
"localName":"county",
"like":"County",
"display":false,
"content":"New York"
},
"L3":{
"localName":"state",
"like":"State",
"display":true,
"content":"NY"
}
}
},
"Coordinates":"-73.971787,40.797208,0.000000",
"name":"801 West End Ave",
"description":"house number",
"Style":{
"href":"http://cdn.gis.atlasct.com/content/images/png/pin_poi_small.png"
},
"Region":{
"LatLonAltBox":{
"east":-73.971669,
"south":40.797118,
"north":40.797297,
"west":-73.971906
},
"east":-73.971669,
"maxAltitude":0,
"south":40.797118,
"north":40.797297,
"west":-73.971906
},
"id":"p1"
},
{
"address":"W 96th St, New York, NY 10025",
"ExtendedData":{
"fromLookUp":"false",
"addressTypeId":"100",
"addressId":"26165116"
},
"AddressDetails":{
"Status":{
"Code":1,
"Name":"Successful"
},
"Accuracy":2,
"HouseNumber":"",
"ZoomLevel":-2,
"ZipCode":10025,
"Street":"W 96th St",
"Country":{
"Code":"usa",
"Name":"USA"
},
"AdminAreas":{
"L1":{
"localName":"city",
"like":"City",
"display":true,
"content":"New York"
},
"L2":{
"localName":"county",
"like":"County",
"display":false,
"content":"New York"
},
"L3":{
"localName":"state",
"like":"State",
"display":true,
"content":"NY"
}
}
},
"Coordinates":"-73.971890,40.794690,0.000000",
"name":"W 96th St",
"description":"street",
"Style":{
"href":"http://cdn.gis.atlasct.com/content/images/png/pin_poi_small.png"
},
"Region":{
"LatLonAltBox":{
"east":-73.970703,
"south":40.793792,
"north":40.795588,
"west":-73.973077
},
"east":-73.970703,
"maxAltitude":0,
"south":40.793792,
"north":40.795588,
"west":-73.973077
},
"id":"p2"
},
{
"address":"West End Ave",
"ExtendedData":{
"length":"82",
"typeName":"Start Out On Street",
"baseTypeName":"Start",
"time":"9",
"type":"1",
"baseType":"0",
"direction":"-1"
},
"Coordinates":[
{
"altitude":0,
"latitude":40.79720687866211,
"longitude":-73.97178649902344
},
{
"altitude":0,
"latitude":40.79719161987305,
"longitude":-73.9718017578125
},
{
"altitude":0,
"latitude":40.79655838012695,
"longitude":-73.97225952148438
}
],
"name":"Start out on West End Ave",
"description":"82 meter",
"Style":{
"href":"http://cdn.gis.atlasct.com/content/images/routing/maneuvers/maneuver_start.png"
},
"id":"m1.1"
},
{
"address":"W 98th St",
"ExtendedData":{
"length":"128",
"typeName":"Turn Left On Street",
"baseTypeName":"Turn",
"time":"14",
"type":"5",
"directionName":"Left",
"baseType":"5",
"direction":"0"
},
"Coordinates":[
{
"altitude":0,
"latitude":40.79655838012695,
"longitude":-73.97225952148438
},
{
"altitude":0,
"latitude":40.79600143432617,
"longitude":-73.97093963623047
}
],
"name":"Turn left onto W 98th St.",
"description":"128 meter",
"Style":{
"href":"http://cdn.gis.atlasct.com/content/images/routing/maneuvers/maneuver_turn_left.png"
},
"id":"m1.2"
},
{
"address":"Broadway",
"ExtendedData":{
"length":"166",
"typeName":"Turn Right On Street",
"baseTypeName":"Turn",
"time":"19",
"type":"4",
"directionName":"Right",
"baseType":"5",
"direction":"1"
},
"Coordinates":[
{
"altitude":0,
"latitude":40.79600143432617,
"longitude":-73.97093963623047
},
{
"altitude":0,
"latitude":40.79536819458008,
"longitude":-73.97138977050781
},
{
"altitude":0,
"latitude":40.79505157470703,
"longitude":-73.97161865234375
},
{
"altitude":0,
"latitude":40.7946891784668,
"longitude":-73.97189331054688
}
],
"name":"Turn right onto Broadway.",
"description":"166 meter",
"Style":{
"href":"http://cdn.gis.atlasct.com/content/images/routing/maneuvers/maneuver_turn_right.png"
},
"id":"m1.3"
},
{
"address":"Broadway",
"ExtendedData":{
"length":"0",
"typeName":"End At Street",
"baseTypeName":"End",
"time":"0",
"type":"61",
"baseType":"2",
"direction":"-1"
},
"Coordinates":[
{
"altitude":0,
"latitude":40.7946891784668,
"longitude":-73.97189331054688
},
{
"altitude":0,
"latitude":40.7946891784668,
"longitude":-73.97189331054688
}
],
"name":"End at Broadway.",
"description":"0 meter",
"Style":{
"href":"http://cdn.gis.atlasct.com/content/images/routing/maneuvers/maneuver_end.png"
},
"id":"m1.4"
}
],
"name":"801 West End Ave, New York, NY 10025 to W 96th St, New York, NY 10025",
"Region":{
"LatLonAltBox":{
"east":-73.97094,
"south":40.79469,
"north":40.797208,
"west":-73.97226
},
"east":-73.97094,
"maxAltitude":0,
"south":40.79469,
"north":40.797208,
"west":-73.97226
},
"Projection":"LatLong",
"Summary":{
"Description":"Route length is 376 Meters and approximated time is 1 minutes.",
"Length":376.2,
"UnitSystem":"Meter",
"Time":0
},
"id":"Routing",
"TimeStamp":"2017-04-24T18:03:04Z"
}