api.automapa.comv3 - alle Systeme normal

Straßensegment-Info abrufen

Road.getSegmentInfo

Gibt Informationen zum Straßensegment zurück, das dem GPS-Punkt am nächsten liegt.

POST/v3/Road/getSegmentInfoapi.automapa.com

Body-Parameter

AnfragetextTypBeschreibung
xdouble ERFORDERLICHGPS x (longitude).
ydouble ERFORDERLICHGPS y (latitude).
dirintegerHeading 0–359, -1 for unspecified.
distLimitintegerSnap radius in metres (default 50).
minCategoryintegerMinimum road category for snapping (default 0).
ignoreNoWaySegmentsboolIgnore fully-no-way segments. Default false.
treatTruckTollsAsTollsboolCount truck tolls as tolls. Default false.
ignoreSegmentsUnderConstructionboolSkip segments under construction. Default false.
ignorePhysicallyBlockedSegsboolSkip physically blocked segments. Default false.
useTollsinteger-1/0/1; -1 = ignore, 0 = reject tolled, 1 = allow tolled.
useFerriesinteger-1/0/1; ferry handling.
useHighwaysinteger-1/0/1; motorway handling.

Beispielrequest

{
    "x": 21.00736,
    "y": 52.18288
}

Beispielresponse

{
    "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-Felder

result-FelderTypBeschreibung
segment.idintegerSegment id.
segment.speedLimitintegerSpeed limit.
segment.isTollinteger-1/0/1.
segment.isFerryinteger-1/0/1.
segment.isHighwayinteger-1/0/1.
segment.lengthintegerSegment length in metres.
segment.dirintegerDirection 1 = along, 2 = reverse.
segment.categoryintegerRoad category.
segment.countryintegerCountry id.
segment.placeNamestringNearest place name.
segment.streetNamestringStreet name.
segment.urbanAreainteger0/1 — inside a built-up area.
attractedXdoubleSnapped GPS x.
attractedYdoubleSnapped GPS y.
pureDistanceintegerDistance from original to snapped point (m).