現在地
Q&A
バージョン移行について
いつもNAVI API 1.x, 2.0, CGIからAPI3.0に移行の際はこちらをご参照ください。
機能の移行や契約関連など、ご不明点はお問い合わせフォームまたは担当営業までお問い合わせください。
サービス全般
-
■地図機能
国内の地図をご提供します。オプションで多言語表示も可能です。 また、地下街などの詳細図をご提供します（一部地域のみ）。今後、順次対応エリアを拡大予定です。
■検索機能
住所や郵便番号、駅、施設など、位置情報にまつわる情報を検索できます。 また、天気情報や自動車・歩行者ルート、バス停情報など、位置情報に付随する情報もご提供いたします（一部有料オプション）。
提供している機能や、今後追加予定の機能などは、いつもNAVI API3.0 マニュアルをご確認ください。
-
主な違いは以下の通りです。
WebAPI：命令処理をサーバ側で行います。多量のデータ処理に最適です。
JavaScriptAPI：命令処理をクライアント側で行います。地図のスクロールや拡大縮小など、動きを表現するのに適しています。JavaScriptの環境下でご利用いただけます。
どちらも地図表示や検索機能を提供しておりますので、用途にあった機能をご利用ください。
詳細はいつもNAVI API3.0 マニュアルをご確認ください。
-
検証環境は開発および検証段階で接続するサーバで、接続は課金対象外です。
本番環境はサービス運用段階で接続するサーバで、接続は課金対象です。
詳細は認証と接続先についてをご確認ください。
-
IP認証、リファラ認証、OAuth認証をご利用いただけます。
詳細は認証と接続先についてをご確認ください。
-
MobileSDKはモバイルアプリでご利用いただけます。
詳細はこちらからご確認ください。
いつもNAVI API3.0 マニュアル（MobileSDK）
- いつもNAVI APIのご利用は、インターネットへの接続が必要です。
- 英語、中国語（簡体字・繁体字）、韓国語の地図と検索データをご提供しております。
-
また、地図作成はタイ語もご提供しております。
詳細は多言語マップタイプをご確認ください。
- いつも NAVI API 3.0 サービス利用条件（PDF）をご確認ください。
-
Point Of Interestの略で、緯度経度や名称、住所をはじめとする情報を保持した施設データを意味します。
いつもNAVI APIでは、株式会社ゼンリンが収集したデータに基づくPOIを約66万件提供しております。
-
株式会社ゼンリンのデータを利用しております。
また、一部オプション機能では協力会社にデータ提供を受けております。
機能ごとの情報提供元はこちらをご確認ください。
-
使用できる測地系は日本測地系、世界測地系の2種類あります。
また、日本測地系はベッセル楕円体準拠の旧日本測地系(TOKYO)、世界測地系はGRS80楕円体準拠の測量成果2000(JGD2000)をそれぞれ採用しています。
-
いつもNAVI Web版では、ゼンリン社提供のデータに加え、3rdパーティコンテンツのデータを使用しています。
検索仕様が一部異なる部分がありますので一致しないことがあります。
予めご了承ください。
-
SNI非対応の環境につきましては、使用するいつもNAVI API/CGIバージョンによっては動作しないことが確認されています。
今わかっている主なSNI非対応環境(すべて製造元サポート終了製品となります)-
【PC】
・WindowsXPで動くすべてのアプリ
・Mac OS X v10.5.5以前で動くすべてのアプリ
・Internet Explorer 6以前
・Mozilla Firefox 2.0未満
・Opera 8.0未満
・Google Chrome 6未満
【モバイル】
・iOS4.0未満
・BlackBerry ブラウザ (7.1以前)
・Windows Mobile 6.5[40]以前
・Android 3.0未満
・Android SDK 2.3未満でビルドされたアプリ(OS要件を満たしてもSNI非対応)
【サーバ】
・wget 1.14未満
・Java 1.6以前
-
【PC】
-
HTTP通信も可能ですが、認証キーが露出するため非推奨となっております。HTTPS通信をご利用ください。
なお、HTTP通信の場合のご利用可能なポート番号は80番になります。
機能
地図描画
- 担当営業に問い合わせください。
- 文字の重複などを考慮して目標物となるような種類・分類から、無作為自動抽出プログラムにて採択されて表示されております。
- 地図データの更新頻度はこちらをご確認ください。
- こちらをご確認ください。
-
外部ライブラリやフレームワークとの併用はできますが、組み合わせによっては一部CSSでの表示が崩れる場合があります。
あわせてこちらもご確認ください。
-
詳細図とは、通常の地図では表示できない地下通路や一部建物内の表示ができる地図機能です。
通常地図と重ねて表示させる場合、地図表示+詳細図表示で追加PVカウントされます。
詳細図内に1F、B1F、B2Fのように階層がある場合、階層切り替え時のpvカウントはありません。
-
APIでは重畳件数に制限を設けておりません。
一度に多量のウィジットを重畳した場合、端末の処理性能が落ちる可能性があります。
-
ローダーに指定するJavaScriptファイルの指定順序によっては地図が正常に表示できない場合があります。
wms.jsはapiパラメータの最後に指定をお願いします。
合わせてこちらもご確認ください。
住所検索
-
指定ワードに一切数字が含まれていない場合は街区までで検索しております。
例えば、街区以下が漢数字(一丁目二番三号)の場合は、地番・枝番レベルでは結果が取得できません。
-
地番・枝番レベル代表点から近い位置を基準に地番・枝番を選択します。
下図は地番①内に指定座標がありますが、検索結果としては地番②として出力されます。
このように、指定座標と地番・枝番代表点の距離によっては意図しない結果になる場合もあります。
-
住所データを利用しているAPIにおいて返却される郵便番号は大字レベルまでしか保証しておりません。
また、全て1丁目の郵便番号を返却する仕様としております。
詳細な郵便番号取得につきましては、郵便番号取得APIをご利用ください。
■ 住所データを利用しているAPI- フリーワードでの住所検索(address/word)
- 住所コードの下位階層住所一覧検索(address/list)
- 住所コードでの住所検索(address/code)
- 緯度経度での住所検索(location)
■ 郵便番号取得API
poi検索
-
データの翻訳数などの状況によっては結果件数が少なくなります。
ジャンルごとの翻訳件数はジャンルコード一覧（多言語対応版）で確認できます。
ルート検索
-
自動車ルート検索で使用しているルート検索エンジンの仕様は各社ごとに違います。
ですので、距離や指定条件によっては他社サービスと結果が同様になる保証はしていません。
-
時刻表を用いないルート検索の場合、基本的には日中時間帯の所要時間の平均値を用いております。
全ての列車というわけではなく、快速列車が停車する場合は快速列車の所要時間を用いるなど、
運航パターンにあわせた形になります。
※バスについては各社ごとに入手できるデータ形式が異なるため、
それぞれで対応が一定でない可能性があります。(2017/10/26時点)
-
推奨ルートとは、有料道路を利用し、通りやすさ、所要時間、距離などをバランスよく考慮したルートのことです。
別ルート優先とは、推奨ルートの結果を除いた場合の推奨ルートです。
ただし、優先させるだけですので通行可能な道が一つしかない時などは推奨ルートと同じ結果となる場合があります。
-
推奨ルートの場合で有料道、一般道、細街路のおおよその値です。※あくまで目安です。
車線数 有料道 一般道 細街路 2車線以下 50km 30km 5km 3車線以上 70km 35km 5km
道路リンク/マップマッチング
-
■図解(PDF)参照
■道路リンク検索
・最寄り道路リンク地点検索
複数の入力点をそれぞれ一番近い道路リンク上にマッチングします。前後の点の関係は考慮されません。
・周辺道路リンク検索
座標1点を指定し、指定範囲内のすべての道路リンク情報を取得します。
■マップマッチング
・ルートマッチング
移動経路を推定し経路のリンク情報を返却します。自動車、歩行者でそれぞれの自動車ネットワークを使用しています。
-
トポロジカルアルゴリズムを採用しています。
リンク間の接続情報（一方通行等）と、進行経路を考慮し、通った可能性のある経路を絞り込んでいきます。
こちら(PDF)もご参照ください。
天気検索
-
各都道府県をいくつかに分けた区域を指します。
詳細はこちらをご確認ください。
-
アメダス観測地点からおおよそ半径2.5km以内のエリアを代表した予報となります。
アメダス観測所一覧はこちらをご確認ください。
-
含まれます。雪が融けたときの水量を降水量に換算し、
それが降る確率も降水量としています。
-
更新頻度は不定期で、情報元は気象庁となります。
詳細はこちらをご確認ください。
-
気象庁の「UVインデックス」を基にしています。詳細はこちらをご確認ください。※2019年7月時点
コード UV情報 説明 0 なし 情報なし 1 弱い 安心して戸外で過ごせます。 2 中程度 日中は出来るだけ日陰を利用してください。出来るだけ長袖シャツ、日焼け止め、帽子を利用してください。 3 強い 日中は出来るだけ日陰を利用してください。出来るだけ長袖シャツ、日焼け止め、帽子を利用してください。 4 非常に強い 日中の外出は出来るだけ控えてください。必ず長袖シャツ、日焼け止め、帽子を利用してください。 5 極端に強い 日中の外出は出来るだけ控えてください。必ず長袖シャツ、日焼け止め、帽子を利用してください。
-
詳細天気検索の落雷情報は、とある気圧断面の空気温度の昇降がどの程度であったかどうかで判別をしています。※2019年7月時点
コード 落雷情報 説明 0 なし 0℃以上 1 弱雷 0℃以下 2 中雷 -1.5℃以下 3 強雷 -3.1℃以下
-
詳細天気検索の霧情報は、とある区域内で降雨無し、且つ風速2m/s以下の時の湿度によって濃薄を決定しています。※2019年7月時点
コード 霧情報 説明 0 なし 90%未満 1 薄霧 90%以上 2 濃霧 95%以上 3 雨 雨の時
-
気象コンテンツ検索で取得できる降水量、積算降水量には以下の違いがあります。
・降水量…5分毎に取得しmm/h換算した瞬間的な降水量
・積算降水量…該当地点で1時間に何mm降る予定かを示した降水量
利用登録
-
いつもNAVI APIに接続する、リンク元URLを意味します。
設定の際は、スキームはhttpsを指定し、ホスト名はIPアドレス/ドメインのいずれかで指定してください。
サブドメイン・パス・ファイル名を含めたURLでは、ブラウザによっては認証エラーとなる可能性があります。
例の通りドメイン部までのURLで指定ください。
例）APIを利用するページのURLが https://www.domain.co.jp/sample/ の場合
「https://domain.co.jp/」と「https://www.domain.co.jp/」の両方を指定ください。
※リファラは複数登録可能です。
※今後ブラウザのポリシー変更等により、設定したリファラの内容で接続できなくなる可能性があります。
-
認証方法により異なります。
・IP認証
セグメント単位で利用可能です。
OK例：123.123.123.* ,123.123.*.*
NG例：123.123.*.123, 123.123.12*.123
・リファラ認証
利用できません。
複数のリファラを纏めて許可する場合、先頭から共通する部分のみを申請するようにお願い致します。
OK例：https://www.zenrin-datacom.net/
NG例：https://*.zenrin-datacom.net/
詳しいご利用条件は設定申込書(excel)をご確認ください。
- 設定申込書（excel）に内容記載のうえ、担当営業までお送りください。
- OAuth署名の作成手順をご確認ください。
契約
-
まずはAPIをテスト利用いただき、ご導入いただける場合には担当営業宛てにお申込みいただきます。
詳細はご利用までの流れをご確認ください。
- 担当営業までお問い合わせください。
- いつも NAVI API 3.0 サービス利用条件（PDF）をご確認ください。
課金・支払
-
PVカウントの定義はこちらをご確認ください。
例）
地図を拡大・縮小するとき：カウントされません
地図をスクロールするとき：カウントされません
JavaScriptAPIの検索（ZDC.Search.getByZmaps）を利用するとき：利用するWebAPIとしてカウントされ、JavaScriptAPIの検索としてはカウントされません。
- 費用は変わりません。PVカウントによる従量課金です。
- いつも NAVI API 3.0 サービス利用条件（PDF）をご確認ください。
- いつもNAVI デベロッパーズサイトをご確認ください。設定申込書に記載されたIDとパスワードでログインいただけます。
- 可能です。テストキーを発行いたしますので、担当営業またはこちらからお問い合わせください。
複製
-
地図のメディア利用については、地図の著作権の関係上、ゼンリンへ地図複製利用申請を行う必要があります。当社地図サービスをご利用いただいているお客様につきましては、当社が代行して申請を行うことも可能です。
ゼンリン 地図複製等利用のご案内
Copyright(C) 2018 ZENRIN DataCom CO.,LTD. All Rights Reserved.