Directions 15 API

VPC環境で利用できます。

入力した情報(出発地、経由地、目的地など)をもとに、車のルートと通行情報(所要時間、距離、予想ガソリン代、通行料金情報、分岐点案内)を照会します。

リクエスト

リクエスト形式を説明します。リクエスト形式は次の通りです。

リクエストヘッダ

Maps APIで共通して使用されるヘッダの詳細は、Mapsの共通ヘッダをご参照ください。

リクエストクエリパラメータ

リクエストクエリパラメータの説明は次の通りです。

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-direction-15/v1/driving?start=127.1058342%2C37.359708&goal=129.075986%2C35.179470' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

route.{option}

route.{option}の説明は次の通りです。

section

sectionの説明は次の通りです。

混雑度の基準
混雑度の基準は次の通りです。

guide

guideの説明は次の通りです。

分岐点案内コード
分岐点案内コードの説明は次の通りです。

レスポンスステータスコード

レスポンスステータスコードの説明は次の通りです。

レスポンス例

レスポンスのサンプルコードは次の通りです。

{
    "code": 0,
    "message": "ルートが見つかりました。",
    "currentDateTime": "2024-08-27T17:17:21",
    "route": {
        "traoptimal": [
            {
                "summary": {
                    "start": {
                        "location": [
                            127.1058342,
                            37.3597080
                        ]
                    },
                    "goal": {
                        "location": [
                            129.0759854,
                            35.1794698
                        ],
                        "dir": 2
                    },
                    "distance": 378984,
                    "duration": 15213293,
                    "departureTime": "2024-08-27T17:17:20",
                    "bbox": [
                        [
                            127.0999824,
                            35.1793190
                        ],
                        [
                            129.0817364,
                            37.3940298
                        ]
                    ],
                    "tollFare": 19300,
                    "taxiFare": 348820,
                    "fuelPrice": 45283
                },
                "path": [
                    [
                        127.1059979,
                        37.3597094
                    ],
                    // (省略)
                    [
                        129.0762855,
                        35.1793190
                    ]
                ],
                "section": [
                    {
                        "pointIndex": 826,
                        "pointCount": 1430,
                        "distance": 151091,
                        "name": "中部内陸高速道路",
                        "congestion": 1,
                        "speed": 99
                    },
                    {
                        "pointIndex": 2255,
                        "pointCount": 564,
                        "distance": 61004,
                        "name": "京釜高速道路",
                        "congestion": 1,
                        "speed": 104
                    },
                    {
                        "pointIndex": 2818,
                        "pointCount": 827,
                        "distance": 82790,
                        "name": "中央高速道路(釜山-大邱)",
                        "congestion": 1,
                        "speed": 102
                    }
                ],
                "guide": [
                    {
                        "pointIndex": 50,
                        "type": 3,
                        "instructions": "モネ公園交差点で「西盆唐(高基) IC」方面に右折",
                        "distance": 1075,
                        "duration": 284218
                    },
                    // (省略)
                    {
                        "pointIndex": 4054,
                        "type": 88,
                        "instructions": "目的地",
                        "distance": 904,
                        "duration": 107763
                    }
                ]
            }
        ]
    }
}