Mapsの概要
- 印刷する
- PDF
Mapsの概要
- 印刷する
- 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ユーザーからのよくある質問
- お問い合わせ: ご利用ガイドだけでは不明な点が解消されない場合、直接お問い合わせ
この記事は役に立ちましたか?