Mapsの概要

印刷する
共有
Twitter
Linkedin
Facebook
Email
PDF

記事の要約

この要約は役に立ちましたか?

ご意見ありがとうございます

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についてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。

Maps APIの使用方法
- APIの概要: NAVERクラウドプラットフォームから発行された Access Key、Secret Keyの発行と確認、リクエストヘッダに必要な署名の作成方法
- API Gatewayご利用ガイド: リクエストヘッダに必要な API Keyの確認方法
- Ncloudの共通レスポンスステータスコード: Mapsサービスで使用される NAVERクラウドプラットフォームの共通レスポンスステータスコード情報
Mapsサービスの使用方法
- Mapsご利用ガイド: NAVERクラウドプラットフォームコンソールで Mapsを使用する方法
- Ncloud使用環境ガイド: VPC、Classic環境とサポートの有無に関するご利用ガイド
- 料金の紹介、特徴、詳細機能: Mapsの料金体系、特徴、詳細機能のサマリー
- サービス関連の最新のお知らせ: Maps関連の最新共有ニュース
- よくある質問: Mapsユーザーからのよくある質問
- お問い合わせ: ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ

この記事は役に立ちましたか?

Mapsの共通設定
- リクエスト
- レスポンス
Maps API
Maps関連リソース