Получить информацию о дорожном сегменте
Road.getSegmentInfo
Возвращает информацию о дорожном сегменте, ближайшем к заданной GPS-точке.
Параметры body
| Тело запроса | Тип | Описание |
|---|---|---|
x | double ОБЯЗАТЕЛЬНО | GPS x (longitude). |
y | double ОБЯЗАТЕЛЬНО | GPS y (latitude). |
dir | integer | Heading 0–359, -1 for unspecified. |
distLimit | integer | Snap radius in metres (default 50). |
minCategory | integer | Minimum road category for snapping (default 0). |
ignoreNoWaySegments | bool | Ignore fully-no-way segments. Default false. |
treatTruckTollsAsTolls | bool | Count truck tolls as tolls. Default false. |
ignoreSegmentsUnderConstruction | bool | Skip segments under construction. Default false. |
ignorePhysicallyBlockedSegs | bool | Skip physically blocked segments. Default false. |
useTolls | integer | -1/0/1; -1 = ignore, 0 = reject tolled, 1 = allow tolled. |
useFerries | integer | -1/0/1; ferry handling. |
useHighways | integer | -1/0/1; motorway handling. |
Пример запроса
{
"x": 21.00736,
"y": 52.18288
}Пример ответа
{
"result": {
"attractedX": 21.0070737,
"attractedY": 52.18288,
"pureDistance": 10,
"segment": {
"class": 3,
"country": 31,
"dir": 0,
"id": 37530,
"isFerry": -1,
"isHighway": -1,
"isToll": -1,
"length": 55,
"placeName": "Warszawa",
"speedLimit": 5,
"streetName": "Domaniewska",
"urbanArea": 1
}
}
}поля result
| поля result | Тип | Описание |
|---|---|---|
segment.id | integer | Segment id. |
segment.speedLimit | integer | Speed limit. |
segment.isToll | integer | -1/0/1. |
segment.isFerry | integer | -1/0/1. |
segment.isHighway | integer | -1/0/1. |
segment.length | integer | Segment length in metres. |
segment.dir | integer | Direction 1 = along, 2 = reverse. |
segment.category | integer | Road category. |
segment.country | integer | Country id. |
segment.placeName | string | Nearest place name. |
segment.streetName | string | Street name. |
segment.urbanArea | integer | 0/1 — inside a built-up area. |
attractedX | double | Snapped GPS x. |
attractedY | double | Snapped GPS y. |
pureDistance | integer | Distance from original to snapped point (m). |