Map-match a GPX file

POST

/match

To get a match response you send a GPX file in the body of an HTTP POST request and specify request parameters like the key and profile in the URL.
See below for more supported parameters.

请求参数

Authorization

API Key

在 query 添加参数

key

示例：

key: ********************

Query 参数

Body 参数application/gpx+xml必填

示例

<gpx>
  <trk>
    <trkseg>
      <trkpt lat="51.343657" lon="12.360708"></trkpt>
      <trkpt lat="51.343796" lon="12.361337"></trkpt>
      <trkpt lat="51.342784" lon="12.361882"></trkpt>
    </trkseg>
  </trk>
</gpx>

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/match?gps_accuracy=undefined&profile=undefined&locale=undefined&elevation=undefined&details=undefined&instructions=undefined&calc_points=undefined&points_encoded=undefined&key=%3Capi-key%3E' \
--header 'Content-Type: application/gpx+xml' \
--data '<gpx>
  <trk>
    <trkseg>
      <trkpt lat="51.343657" lon="12.360708"></trkpt>
      <trkpt lat="51.343796" lon="12.361337"></trkpt>
      <trkpt lat="51.342784" lon="12.361882"></trkpt>
    </trkseg>
  </trk>
</gpx>'

返回响应

🟢200成功

application/json

Map matching result

Headers

Bodyapplication/json

示例

{
    "paths": [
        {
            "distance": 0,
            "time": 0,
            "ascend": 0,
            "descend": 0,
            "points": "string",
            "snapped_waypoints": "string",
            "points_encoded": true,
            "bbox": [
                0
            ],
            "instructions": [
                {
                    "text": "string",
                    "street_name": "string",
                    "distance": 0,
                    "time": 0,
                    "interval": [
                        0
                    ],
                    "sign": 0,
                    "exit_number": 0,
                    "turn_angle": 0
                }
            ],
            "details": {},
            "points_order": [
                0
            ]
        }
    ],
    "info": {
        "copyrights": [
            "string"
        ],
        "took": 0
    }
}

修改于 2025-11-25 06:18:54

Retrieve result of a matrix computation job

Geocoding Endpoint