Directions 5 API

VPC環境で利用できます。

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

リクエスト

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

リクエストヘッダ

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

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

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

リクエスト例

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

curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-direction/v1/driving?goal=129.075986%2C35.179470&start=127.1058342%2C37.359708' \
--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-09-03T14:39:25",
    "route": {
        "traoptimal": [
            {
                "summary": {
                    "start": {
                        "location": [
                            127.1058342,
                            37.3597080
                        ]
                    },
                    "goal": {
                        "location": [
                            129.0759854,
                            35.1794698
                        ],
                        "dir": 2
                    },
                    "distance": 380044,
                    "duration": 15856847,
                    "departureTime": "2024-09-03T14:39:24",
                    "bbox": [
                        [
                            127.0833901,
                            35.1793190
                        ],
                        [
                            129.1969372,
                            37.3597094
                        ]
                    ],
                    "tollFare": 21000,
                    "taxiFare": 352360,
                    "fuelPrice": 45056
                },
                "path": [
                    [
                        127.1059979,
                        37.3597094
                    ],
                    // (省略)
                    [
                        129.0762855,
                        35.1793190
                    ]
                ],
                "section": [
                    {
                        "pointIndex": 315,
                        "pointCount": 1018,
                        "distance": 95575,
                        "name": "京釜高速道路",
                        "congestion": 1,
                        "speed": 83
                    },
                    {
                        "pointIndex": 2157,
                        "pointCount": 812,
                        "distance": 92508,
                        "name": "尚州永川高速道路",
                        "congestion": 1,
                        "speed": 108
                    },
                    {
                        "pointIndex": 2968,
                        "pointCount": 833,
                        "distance": 89391,
                        "name": "京釜高速道路",
                        "congestion": 1,
                        "speed": 106
                    }
                ],
                "guide": [
                    {
                        "pointIndex": 50,
                        "type": 3,
                        "instructions": "モネ公園交差点で「西盆唐(高基) IC」方面に右折",
                        "distance": 1075,
                        "duration": 262406
                    },
                    // (省略)
                    {
                        "pointIndex": 4065,
                        "type": 88,
                        "instructions": "目的地",
                        "distance": 904,
                        "duration": 147960
                    }
                ]
            }
        ]
    }
}