タイル地図スクリプト取得(v2)
/v2/map_script [GET]
基本情報
概要
ブラウザ上で動作するタイル地図を制御するJavaScriptファイルを取得します。
URL
https://{HOST}/{CID}/v2/map_script
※APIマーケットでは提供しておりません
出力形式
- JavaScript
対応言語
- ja
本 API を使用する際は、お客様のWebサイト内に 利用規約の表示について にある規約文言を記載してください。
地図の表示数について
地図の表示は1画面につき1枚までとなります。
複数枚の表示につきましてはサポート対象外となります。
User-Agentについて
User-Agent(リクエストヘッダー)からブラウザを判別し、最適なスクリプト返却します。
JavaやPythonなどのプログラムからリクエストする際は、アプリケーション側の地図表示で利用するブラウザのUser-Agentを明示的に付与してください。
API コール数のカウントについて
/map_script の実行 1 回につき 1 コールとカウントされます。
地図のスクロール操作やスクリプト内部の関数呼び出しなどはカウントされません。
地図操作について
地図操作のチュートリアルにつきましては Map Tutorial も併せてご覧ください。
パラメータ
パラメータ名 | 必須 | 概要 | 型名 | デフォルト値 | 上下限/選択値 | 備考 |
---|---|---|---|---|---|---|
host | ✔ | サイトのドメイン | 文字列 | ローカル環境から取得する場合は、「localhost」と指定してください サイト上で取得する場合は、ドメイン名を指定してください(パラメータ構成例を参考にしてください) |
パラメータ構成例
- https://example.com/foo/baa.html のサイト上でタイル地図スクリプトを取得
/map_script?host=example.com
測地系について
タイル地図スクリプトは 世界測地系でのみご利用頂けます。
サポートブラウザと差分について
サポートブラウザと差分については以下のとおりです。
PC
ブラウザ | サポートブラウザの バージョン |
キーボード 入力対応 |
マルチタッチ 操作対応 |
ズームバー 表示 |
メニュー表示 |
---|---|---|---|---|---|
Google Chrome |
最新2バージョン | ○ | ○ | × | ○ |
Firefox | 最新2バージョン | ○ | ○ | × | ○ |
Microsoft Edge |
最新2バージョン | ○ | ○ | × | ○ |
safari(Mac) | 最新2バージョン | ○ | ○ | × | ○ |
Internet Explorerは非対応となります。 Internet Explorerにて地図表示をする場合は/v1/map_scriptをご利用ください。
「マルチタッチ操作対応」は、タッチパネルを搭載したPC上での操作を指します。
モバイル
ブラウザ | サポートブラウザの バージョン |
キーボード 入力対応 |
マルチタッチ 操作対応 |
ズームバー 表示 |
メニュー表示 |
---|---|---|---|---|---|
safari | 最新2バージョン | × | ○ | × | × |
Google Chrome( for Android ) | 最新2バージョン | × | ○ | × | × |
ブラウザの動作保証について
API では UserAgent を取得してブラウザごとに配信するスクリプトファイルを適宜切り替えています。
●/v1/map_scriptで対応していたInternet Explorer、Opera、Android標準ブラウザは動作保証対象外になります。
●互換表示モード(エミュレート)でのご使用も保証対象外になります。