Estimated Time of Arrival (ETA)

Basic principles

This web service gives time to arrive to destination accounting real-time traffic.

Route calculation example 

{
        "url":"https://api.geoconcept.com/EU/GCW/geoconcept-web/api/lbs/eta.json",
        "type":"GET",
        "params": {
                "origin": {
                        "sample":"-1.351448,47.446923"
                },
                "destination": {
                        "sample":"-1.34529,47.4479931"
                },
                "configName": {
                        "sample":"car"
                }
        }
}

Parameters / properties

Input

parameter description optional default

configName

Name of the configuration to use:
- bus
- car
- delivery light vehicle
- delivery truck vehicle
- emergency truck
- emergency vehicle
- taxi
- truck

yes

car

origin

Coordinates of the start point (longitude, latitude).
The longitude and latitude coordinates are separated by the , character.

no

destination

Coordinates of the end point (longitude,latitude).
The longitude and latitude coordinates are separated by the , character

no

srs

projection (EPSG code such as epsg:4326 or wgs84)

yes

epsg:4326

Output

Route (routeResult)

parameter type min/max description

time

double

0/1

Remaining journey time in seconds.

distance

double

0/1

Total route distance in meters.

Possible returns

Case of a route found (etaResult/status is OK)  

{
   "time": 110,
   "distance": 630
}

Case of a forgotten specification of a start or finish point (etaResult/status is ERROR)  

{
   "message": "ServiceException: invalid coordinates ''",
   "status": "ERROR"
}

Case of a non existing graphName (etaResult/status is ERROR)  

{
   "message": "ServiceException: Cannot retrieve Graph Definition for configuration xxx",
   "status": "ERROR"
}

Prev  Up  Next
  Home