Mapsの概要

Prev Next

Classic/VPC環境で利用できます。

Mapsは、NAVER地図コンテンツとデータを活用して、位置情報基盤サービスの作成をサポートする NAVERクラウドプラットフォームのソフトウェアインターフェースです。静的地図画像の作成、ルート検索、住所検索、住所変換機能関連の APIを RESTful形式で提供します。APIを呼び出すには、API Gatewayの IAM認証が必要です。

Mapsの共通設定

Maps APIで共通して使用されるリクエスト形式とレスポンス形式を説明します。

リクエスト

共通リクエスト形式を説明します。

API URL

リクエスト API URLは次の通りです。

Static Map: https://naveropenapi.apigw.ntruss.com/map-static/v2
Directions 5: https://naveropenapi.apigw.ntruss.com/map-direction/v1
Directions 15: https://naveropenapi.apigw.ntruss.com/map-direction-15/v1
Geocoding: https://naveropenapi.apigw.ntruss.com/map-geocode/v2
Reverse Geocoding: https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2

リクエストヘッダ

ヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-api-key-id Required NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client ID
x-ncp-apigw-api-key Required NAVERクラウドプラットフォームコンソールで Application登録後に発行された Client Secret
参考

NAVERクラウドプラットフォームコンソールで Applicationを登録して APIの使用に必要な認証情報(Client ID、Client Secret)を発行する方法はの詳細は、Mapsご利用ガイドをご参照ください。
コンソールで Applicationを登録した後に APIが選択されているか [変更] ボタンをクリックして確認してください。選択されていないと429(Quota Exceed)エラーが発生します。

レスポンス

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

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

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

HTTPステータスコード コード メッセージ 説明
400 100 Bad Request Exception リクエスト構文エラー
401 200 Authentication Failed 認証失敗
401 210 Permission Denied アクセス権限なし
404 300 Not Found Exception サーバで見つからない
413 430 Request Entity Too Large リクエストサイズ(10MB)超過
429 400 Quota Exceeded リクエストの割り当て量超過
429 410 Throttle Limited 早すぎるか、あまりにも頻繁なリクエスト
429 420 Rate Limited 特定の時間に過剰なリクエスト
503 500 Endpoint Error エンドポイントエラー
504 510 Endpoint Timeout エンドポイントタイムアウト
500 900 Unexpected Error 不明なエラー
参考

NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

Maps API

Mapsサービスで提供する APIの説明は次の通りです。

API 説明
Static Map 静的地図画像を作成
Directions 5 ルート検索(経由地は最大5個)
Directions 15 ルート検索(経由地は最大15個)
Geocoding 住所を検索
Reverse Geocoding 座標を住所に変換

Maps関連リソース

Maps APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。