This web service calculates an isochrone/isodistance from a point and returns the geometry of the zone calculated.
{
"url":"https://api.geoconcept.com/EU/GCW/geoconcept-web/api/lbs/isochrone/v5.json",
"type":"GET",
"params": {
"location": {
"sample":"2.321134,48.796575"
},
"distance": {
"sample":"1000"
},
"time": {
"sample":"60"
},
"method": {
"sample":"time"
},
"exclusions": {
"sample":""
}
}
}
Input
| parameter | description | optional | default |
|---|---|---|---|
|
id |
Isochrone identifier |
yes |
|
|
location |
Start (or arrival point, if the |
no |
|
|
srs |
projection (EPSG code such as epsg:4326 or wgs84) |
yes |
epsg:4326 |
|
exclusions |
List of restriction rules to use, separated by the ; character |
yes |
|
|
method |
"time" for isochrone or "distance" for isodistance |
no |
time |
|
time |
Maximum access time, in seconds |
yes |
|
|
distance |
Maximum access distance, in meters |
yes |
|
|
reverse |
if true, the |
yes |
false |
|
smoothing |
Smoothing |
yes |
false |
|
resolution |
Resolution (int) of the resulting isochrone, in meters. Do not set this parameter to stay in automatic resolution mode |
yes |
auto |
|
holes |
Display holes in the result zone (the geometry returned is more voluminous when this parameter is set to true) |
yes |
false |
|
startDateTime |
Start date and time (format ISO8601: local time) Example: 2014-01-21T09:00:00.000+01:00 (or 2014-01-21T09:00:00.000%2B01:00) for a departure on 21 Januray 2014, at 9.00am in Paris |
yes |
|
|
snapMethod |
Method for snapping to the graph |
yes |
standard |
|
avoidArea |
Forbidden transit zone in WKT format (POLYGON or MULTIPOLYGON) in the requested projection (srs parameter) |
yes |
|
|
configName |
Name of the configuration to use: |
yes |
|
|
computeOptions |
Selection of variables to use in calculations, using semi-colons ; as separators: |
yes |
Output
Isochrone (isochroneResult)
| parameter | type | min/max | description |
|---|---|---|---|
|
id |
string |
0/1 |
Isochrone identifier |
|
location |
string |
0/1 |
Start (or Finish if the |
|
srs |
string |
0/1 |
projection |
|
time |
string |
0/1 |
Maximum access time, in seconds |
|
distance |
string |
0/1 |
Maximum access distance, in meters |
|
wktGeometry |
string |
0/1 |
Geometry of the isochrone, in wkt format |
Case of an isochrone/isodistance that has been found (status is OK)
{
"message": null,
"status": "OK",
"id": null,
"location": "2.321134,48.796575",
"srs": "epsg:4326",
"time": "60",
"distance": null,
"wktGeometry": "POLYGON ((2.32113 48.795216, 2.32113 48.795996, 2.319976 48.795996, 2.319976 48.795606, 2.3194 48.795606, 2.3194 48.795216, 2.318823 48.795216, 2.318823 48.794826, 2.318246 48.794826, 2.318246 48.795606, 2.317092 48.795606, 2.317092 48.795996, 2.318246 48.795996, 2.318246 48.796386, 2.320553 48.796386, 2.320553 48.796776, 2.3194 48.796776, 2.3194 48.797166, 2.319976 48.797166, 2.319976 48.797556, 2.320553 48.797556, 2.320553 48.797166, 2.32113 48.797166, 2.32113 48.796386, 2.321707 48.796386, 2.321707 48.797556, 2.322284 48.797556, 2.322284 48.797946, 2.322861 48.797946, 2.322861 48.797166, 2.323438 48.797166, 2.323438 48.796776, 2.322284 48.796776, 2.322284 48.796386, 2.324015 48.796386, 2.324015 48.795606, 2.323438 48.795606, 2.323438 48.795996, 2.322284 48.795996, 2.322284 48.795606, 2.321707 48.795606, 2.321707 48.794436, 2.32113 48.794436, 2.32113 48.795216))"
}
Case whereby method = distance and distance is not supplied (status is ERROR)
{
message: "distance parameter must not be null or 0 !",
status: "ERROR"
}
Case whereby method + time are not supplied (status is ERROR)
{
"message": "time parameter must not be null or 0 !",
"status": "ERROR"
}
Case whereby the location tag is missing (status is ERROR)
{
message: "Location must be not null",
status: "ERROR"
}
Case whereby the start point is supplied with errors (status is ERROR)
{{
"message": "Location point must have 2 components separated with a ,",
"status": "ERROR"
}
Case of a snap-to-graph error (status is ERROR)
An error occurred : (500) error
ServiceException: Error in isochron computation|Error in smartrouting|Failed to execute calculateConcentricReachableAreas|com.geoconcept.smartrouting.SmartRoutingNativeException: failed to connect isochrone orign { -42.321134, 48.796575, 0.000000 }|failed to connect isochrone orign { -42.321134, 48.796575, 0.000000 }
- 1. Is it possible to give priority to either journey time or distance?
- 2. How do you perform an isochrone/isodistance calculation without any tolls?
- 3. What are the maximum values allowed by predefined configName?
- 4. What are the exclusions available?
- 5. What are the Hazardous material exclusions?
- 6. What are Speed Patterns? How are they used?
- 7. How do you use heavy goods vehicle attributes?
