This web service simultaneously calculates several isochrones/isodistances from points and allow/avoid overlapping between geometries. It returns the geometries of the zones calculated.
{
"url":"https://api.geoconcept.com/EU/GCW/geoconcept-web/api/lbs/isochrone/multi/v2.json",
"method":"POST",
"body":
{
"locations" : [ {
"x":2.321134,
"y":48.796575
},{
"x":2.324340,
"y":48.803376
} ],
"method":"time",
"time" : 180,
"overlapping" : false
}
}
Input
| parameter | description | optional | default |
|---|---|---|---|
|
location (array of Point) |
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 the geometries if the |
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 |
|
overlapping |
To allow/avoid overlapping between geometries |
yes |
true |
|
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 |
Geolocalized point (Point)
| parameter | description | optional | default |
|---|---|---|---|
|
id |
Point identifier |
No |
|
|
x |
First coordinate or longitude |
No |
|
|
y |
Second coordonnée or latitude |
No |
|
|
nodeId |
Point node id on the graph |
No |
Output
| parameter | type | min/max | description |
|---|---|---|---|
|
Isochrones |
array of IsochroneItemResult |
0/unlimited |
List of calculated areas. |
List of calculated isochrones (MultiIsochronesResult)
| parameter | type | min/max | description |
|---|---|---|---|
|
id |
string |
0/1 |
Isochrone identifier |
|
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 |
|
location |
string |
0/1 |
Start (or Finish if the |
|
srs |
string |
0/1 |
projection |
Case of an mulisochrone/isodistance that has been found (status is OK)
{
"status": "OK",
"isochrones": [
{
"location": "2.321134,48.796575",
"time": "180",
"wktGeometry": "POLYGON ((2.326875 48.79561, 2.32712 48.79606, [...]))"
},
{
"location": "2.32434,48.803376",
"time": "180",
"wktGeometry": "POLYGON ((2.32947 48.80445, 2.329245 48.80438, [...]))"
}
]
}
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?
