コンテンツにスキップ

マップマッチ結果取得 API

/mapmatch [GET]

基本情報

概要

企業 ID /分析 ID に紐付く分析結果(走行軌跡)を取得を取得を行います。

実装企業

ナビタイムジャパン

URL

https://{HOST}/mapmatch

出力形式

  • GZIP (application/gzip)
    • 解凍した中身はGeoJSON

パラメータ

パラメータ名 必須 概要 型名 選択値/制限 デフォルト値
company ✔ 企業ID 文字列
user_id ✔ 利用ユーザを識別するID 文字列 半角英数字128文字まで
analyze_id ✔ 分析を識別するID 文字列 半角英数字128文字まで

レスポンス(GeoJSON)

FeatureCollectionオブジェクト

名称 レスポンス名 型名 配列 説明
種別 type 文字列 FeatureCollection を表すタイプ名'FeatureCollection'を出力
形状に関する情報 features Featureオブジェクト 〇

Featureオブジェクト

名称 レスポンス名 型名 配列 説明
種別 type 文字列 Feature を表すタイプ名'Feature'を出力
形状の緯度経度情報 geometry Geometryオブジェクト

Geometryオブジェクト

名称 レスポンス名 型名 配列 説明
種別 type 文字列 Geometry を表すタイプ名'LineString'を出力
緯度/経度 coordinates カンマ区切りの緯度/経度 〇

レスポンス サンプル(StatusCode:200)

{
    "type": "FeatureCollection",
    "features": [
        {
            "geometry": {
                "coordinates": [
                    [
                        130.639495,
                        33.73545
                    ],
                    [
                        130.639752,
                        33.735194
                    ]
                ]
            },
            "type": "Feature"
        },
    ]
}

レスポンス サンプル(StatusCode:400)

{
  "status": "error",
  "error": [
    "Company is not allowed."
  ]
}