よくある質問

スタートガイド

利用規約の理解

使用制限と購入

Google Maps API の使用

Google Maps API サービス

スタートガイド

Google Maps API について教えてください。

Google Maps API を使用すると、デベロッパーはいくつかの方法で Google マップをウェブページに埋め込むことができます。また、使用方法が簡単で広範なカスタマイズが可能です。現在は次の API を提供しています。

必要に応じて、これらの API を単独で使用したり、組み合わせて使用したりできます。

企業ウェブサイトや商用ウェブサイトを運用している場合は、Google Maps API for Work もご確認ください。

必要な API はどれですか?

機能の要件に基づいて適切な API を探す場合は、API Picker をご覧ください。

Google Maps API が対象とする国はどこですか?

Google マップチームは、絶えず新しいマップデータを作り出し、全世界の対象範囲を広げています。最新の対象範囲については、Google マップの対象データをご覧ください。ページ上部のフィルタ ボックスを使用してデータをフィルタリングできます。データ プロバイダとのライセンス契約が変わると、対象データも変わる可能性があります。

関連ドキュメント:

Google Maps API を使わずに Google マップをサイトに配置できますか?

はい。Google マップでは、現在では Google Maps API をプログラミングしたり使用したりすることなく、表示しているマップをウェブサイトやブログに埋め込むことができるようになりました。詳細については、こちらをご覧ください。

モバイル端末でマップ アプリケーションを配信するにはどうすればよいですか?

Google Maps JavaScript API はモバイル端末に対応するように開発されており、JavaScript を完全に実装したウェブブラウザ付きのデスクトップおよび端末(Apple iPhone など)を対象としたブラウザ アプリケーションに適しています。

JavaScript API の使用に適さない端末を対象としたアプリケーションについては、Google Static Maps API がマーカーやポリラインなどの GIF、JPG、PNG 形式のマップ画像を提供しています。ブラウザベースのアプリケーション以外で Google Static Maps API を使用するには、マップ画像を Google マップにリンクする必要があります。

マップを Android アプリケーションに組み込むには、Android マップ外部ライブラリを使用します。

マップをネイティブ iOS アプリケーションに組み込むには、Google Maps SDK for iOS を使用します。

サイトで Google Maps API の使用を開始するにはどうすればよいですか?

Maps Javascript API のドキュメントの例と詳細をご覧ください。

Google Maps API に変更があった場合に通知を受け取るにはどうすればよいですか?

Google Geo デベロッパーの各種提供物のニュース アップデートについては、Google Geo Developers Blog を購読してください。

各 API には通知グループもあり、新リリースなどのアプリケーションに影響する可能性がある変更についてお知らせします。これらのすべてのグループについては、Google Maps API のサポートページをご覧ください。

利用規約の理解

Google Maps API の利用規約について教えてください。

Google Maps API の利用規約は次の場所にあります。

https://developers.google.com/maps/terms

Google Maps API for Work のユーザーである場合は、Google Maps API の使用に関する条件については、契約書をご覧ください。

サイトは Google Maps API の利用規約を満たしていますか?

Maps API は、ユーザーが無料でアクセスできるすべてのサイトで利用できます。サイトが利用規約を満たしている限り、商用ウェブサイトでも非営利ウェブサイトでも Google Maps API を使用できます。

ただし、ある都市の違法ドラッグの購入場所やその他の違法行為を特定するマップなど、表示したくない Google Maps API の用途もあります。ユーザーのプライバシーも尊重するため、Google Maps API を個人情報の特定には使用しないでください。

アプリケーションを開発して起動する前に、そのアプリケーションが利用規約に準拠しているかどうかをご自身でご確認ください。Google のエンジニアは、技術支援を提供するだけで、法的な助言を行う資格はありません。Google は、いつでもサービスの使用を保留または停止する権限を留保します。そのため、利用規約をよくお読みください。

企業ウェブサイトや商用ウェブサイトを運用している場合は、ニーズにより適切になるよう利用規約が修正された Google Maps API for Work もご確認ください。

マップや衛星画像に直接アクセスできますか?

Google Maps API 以外のメカニズム(独自のマッピング API の作成やバルク タイル ダウンロード スクリプトの使用など)ではマップや衛星画像にアクセスできません。アプリケーションによるタイルへのアクセスは、Google Maps API 以外でアクセスした場合はブロックされます。詳細については、Google マップの利用規約のセクション 10.1.a をご覧ください。

Google Maps API は商用ウェブサイトで使用できますか?

ユーザーが無料でサイトに通常アクセスできる限り、Google Maps API を使用できます。たとえば、アドバタイジングでサポートされているウェブサイトは、Google Maps API の利用規約に従っている可能性があります。マップに情報(販売中の住宅のリストなど)を載せるのにユーザーに課金し、その情報を Google Maps API を使用してサイトの無料部分に表示する場合も、Google Maps API の利用規約を満たします。

ただし、すべての商用利用が許可されるわけではありません。たとえば、サイトが次の条件を満たしている場合、適切な Google Maps API for Work ライセンスを購入する必要があります。

  • サイトは課金ユーザーのみが使用できる。
  • サイトに会社内またはイントラネット上でのみアクセスできる。
  • アプリケーションが企業派遣、フリート管理、ビジネス アセット トラッキング、または同様のアプリケーションに関連している。

Google は、いつでも Google Maps API の使用を保留または停止する権限を留保します。そのため、利用規約をよくお読みください。

Google Maps API はトラッキング アプリケーションで使用できますか?

Google Maps API を使用したリアルタイム データの表示(トラッキング)に制限はありません。ただし、アプリケーションが無料で公開され、利用規約に従っている場合に限ります。社内専用アプリケーションの場合、Google Maps API for Work を使用する必要があります。詳細については、利用規約のセクション 10.4 をご覧ください。

Google マップはウェブ以外のアプリケーションで使用できますか?

はい。Google Maps API はデスクトップ アプリケーションで使用できるようになりました。ただし、そのアプリケーションが利用規約の他の制限に従っている場合に限ります。デスクトップ アプリケーションが「一般公開されている」と見なされるには、そのアプリケーションをダウンロードできる一般公開ウェブページが存在する必要があります。詳細については、利用規約のセクション 9.1 をご覧ください。

Google Maps JavaScript API は、いずれかの対応ブラウザで実行されている場合のみサポートされます。

Google Maps API は、パスワードで保護されているサイトで使用できますか?

はい、使用できますが、パスワードで保護されているウェブサイトで Google Maps API 使用する前に、利用規約をご覧ください。ユーザーが無料で簡単にパスワードを取得できる場合、またはパスワードで保護されたマップの目的が一般公開マップの強化(つまり、管理)である場合、サイトは利用規約に従っている可能性があります。それ以外の場合、Google Maps API for Work を使用する必要があります。

Google Maps API アプリケーションのスクリーン ショットを印刷物やオフライン メディアで使用できますか?

印刷物やオフライン メディアでの Google マップ画像の使用には、次で公開されている使用許諾ガイドラインが適用されます。

http://www.google.com/permissions/geoguidelines.html

コンテンツを Google 検索の結果から削除するにはどうすればよいですか?

このデータは収集されなくなりました。indexing パラメータの使用は廃止され、効果がありません。明示的に削除する必要はなくなりましたが、できるだけ早くこのパラメータを削除することをお勧めします。

ページまたはサイトを検索結果から削除するには、ウェブマスター ヘルプセンターに記載されている手順に従ってください。

JavaScript Maps API を使用した場合、どのような情報が Google に送信されますか?

JavaScript Maps API を使用した場合、次の情報が Google に送信されます。

  • マップタイルや著作権を取得するためのマップのサイズと場所
  • ジオコーディング用の住所
  • ルートと標高のリクエスト
  • プレイスを検索する場所
  • KML(KmlLayer を使用する場合)
Google Static Maps API を使用して、ウェブサイトから保存したり提供したりするマップ画像を生成できますか?

ウェブサイトから Google Static Maps API を使用して生成された画像のコピーを保存したり提供したりすることはできません。静的画像を必要とするすべてのウェブページでは、HTML img タグの src 属性または HTML div タグの CSS background-image 属性を直接 Google Static Maps API にリンクして、すべてのマップ画像がウェブページの HTML コンテンツ内に表示され、Google からエンドユーザーに直接提供されるようにする必要があります。

使用制限と購入

使用制限がある Google Maps API はどれですか?

Google Maps API は、さまざまなユースケースに無料でご使用いただけます。また、標準 API の使用には無料の使用制限と予測可能な超過料金の設定が備わっており、企業で展開するための年間契約もご用意しています。

次の API には使用制限がありません。

次の Maps API には使用制限が適用されます。API をクリックすると、使用制限の詳細が表示されます。

Maps API を展開する際は、標準の利用規約に従う必要があります。

Google Maps API の使用制限について教えてください。

ほとんどの Google Maps API には、Google Developers Consoleで設定できる 1 日あたりの無料割り当てが用意されています。1 日あたりのデフォルト クエリと最大クエリは API によって異なります。1 日あたりの無料制限は、課金の有効化またはプレミアム ライセンスの購入によって引き上げることができます。

  • ウェブサービス API:

    Google マップ ウェブサービス API では、1 日あたり 2,500 回のリクエストが無料です。1 日あたりの割り当てを増やすために(1 日あたり最大 100,000 回)、従量課金制の価格設定を提供しています。

    によって従量課金を選択します。

  • ウェブ API:

    Google Maps JavaScript API、Google Static Maps API、および Google Street View Image API には、マップのロードについて 1 日あたり 25,000 回というデフォルトの制限があります。サイトまたはアプリケーションで 1 日あたりのマップのロードが 25,000 回を超える日が 90 日以上続く場合は、お支払いについてご連絡を差し上げます。制限を超えても心配する必要はありません。すぐに API アクセスが遮断されたり、サイトにエラー メッセージが表示されたりすることはありません。

正確な定義については、それぞれの質問をご覧ください。

注:(Google の単独の裁量で)公益に資すると見なされたアプリケーションには、これらの使用制限は適用されません。たとえば、災害救助マップは、営利企業によって開発またはホストされている場合でも、使用制限が適用されません。また、Google Maps API のジオコーディング制限または内部使用量の引き上げが必要な認定非営利組織は、Google Earth Outreach の助成プログラムを通じて Google Maps API for Work ライセンスを申請できます。

割り当ての使用量はどのように計算されますか?

割り当て使用量の計算方法は、API によって異なります。ウェブサービス API ではリクエストを使用します(Google Maps Distance Matrix API では要素を使用します)。ウェブ API ではマップのロードを使用して割り当て使用量を計算します。

Google Maps Distance Matrix API では、API に送信された各クエリは許可されている要素の数で制限され、出発地の数 × 目的地の数によって要素の数が定義されます。

注:Google Maps API Web Service の使用を制限する割り当てタイプには、長期間(1 日あたりの割り当て)と短期間(リクエスト レート割り当て)の 2 つがあります。Elevation API のリクエストごとの場所数制限など、API に追加の制限が設定される場合もあります。Image API には、1 日あたりの割り当てに加えて、最大画像解像度の制限があります。詳細については、各 Google Maps API の使用制限のページをご覧ください。

Google Maps ウェブ API に適用される使用制限に関連して「マップのロード」を引き起こす要因は何ですか?

マップのロードは、次の場合に 1 回行われます。

  1. ウェブページまたはアプリケーションによるロード時に、マップが Google Maps JavaScript API を使用して表示されるとき
  2. マップが表示されていないウェブページまたはアプリケーションによって Google Maps JavaScript API を使用してストリート ビューのパノラマ画像が表示されるとき
  3. Google Static Maps API からマップ画像に対して 1 回のリクエストが行われるとき
  4. Google Street View Image API からパノラマ画像に対して 1 回のリクエストが行われるとき

ユーザーがロード後のマップとやり取りする度合いは、使用制限に影響しません。同じページで Maps API を使用して既にマップを表示しているアプリケーションが Google Maps JavaScript API を使用してストリート ビュー パノラマを表示しても、追加のマップのロードは行われません。

Google Maps API for Work アプリケーションは、マップのロードとは若干異なるページビューによって制限されます。詳細については、Google Maps API for Work のよくある質問をご覧ください。

割り当て使用量を監視するにはどうすればよいですか?

個々の API の割り当て使用量は、Google Developers Consoleで監視できます。

  1. [Project] ドロップダウンから、確認する API が含まれているプロジェクトを選択します。
  2. 有効な API のリストで、API の名前をクリックします。
  3. ページの最上部近くで、[Quota] または [Usage] をクリックします。

注:プロジェクト全体のトラフィック レポートと課金情報を表示するには、まず課金を有効化します。

使用制限を超えた場合はどうなりますか?

特定の Google Maps API の使用制限を超えた場合、API によりエラー メッセージが返されます。制限の超過を繰り返すと、API へのアクセスが一時的にブロックされる場合があります。

  • ウェブサービス API

    Google Maps API Web Service には、使用を制限する割り当てタイプとして、長期間(1 日あたりの割り当て)と短期間(リクエスト レート割り当て)の 2 つがあります。使用制限を超えるかサービスを乱用した場合、ウェブサービスにより特定のエラー メッセージが返されます。制限の超過が続くと、ウェブサービスへのアクセスがブロックされる場合があります。

    Google Maps API Web Service の使用制限は、次の場合に超える可能性があります。

    • 1 日に送信するリクエストの量が多すぎる。
    • リクエストの送信が速すぎる(つまり、1 秒間のリクエスト数が多すぎる)。
    • 長期間にわたってリクエストの送信が速すぎるか、ウェブサービスを乱用している。
    • その他の使用制限の超過(Elevation API のリクエストごとの場所数など)。

    注:4 つのウェブサービス API には、JavaScript API で使用できる同等のクライアント側サービスがあります。それは、DirectionsDistance MatrixElevationGeocoding の各 API です。クライアント側 API には異なる制限が適用されます。JavaScript API は、マップ セッションごとにレートが制限されるため、リクエストはユーザーに分散されます。これにより、ユーザー数の増加に応じてブラウザベースの使用を拡張できます。

  • ウェブ API

    Google Maps JavaScript API v3、Google Static Maps API、および Google Street View Image API では、サイトまたはアプリケーションで 1 日あたりのマップのロード25,000 回を超える日が 90 日以上続く場合、Google から支払いオプションについてご連絡を差し上げます。この時点では、購入期限をお知らせします。この期限までは、ウェブサイトはマップの表示が変わることなく正常に動作を続けます。

    期限を過ぎると、課金を有効化したり Google Maps API for Work ライセンスを購入したりしなければ、ウェブサイト上のマップは、毎日最初の 25,000 回のマップのロード時にのみ動作します。この数を超えると、API は機能しなくなります。

使用制限の超過

使用制限を超えると、レスポンスとして OVER_QUERY_LIMIT ステータス コードを受け取ります。

つまり、ウェブサービスは通常のレスポンスを停止し、使用が再び許可されるまでステータス コード OVER_QUERY_LIMIT のみを返します。この状況は次の間続く可能性があります。

  • アプリケーションが 1 秒間に送信したリクエストが多すぎたためにエラーを受信した場合は、数秒間。
  • アプリケーションが 1 日に送信したリクエストが多すぎたためにエラーを受信した場合は、次の 24 時間。1 日の割り当ては、午前 0 時(太平洋標準時)にリセットされます。

1 日の使用制限を定期的に超える場合は、次の点を検討してください。

  • Google Maps API をより効率的に使用するようにアプリケーションを最適化して、使用量を減らす。
  • プロジェクトの課金を有効にして、使用制限を引き上げる。
  • Google Maps API for Work ライセンスを購入する。
サイトのトラフィックが多い状態です。Maps API を使用できますか?

はい。ただし、アプリケーションで利用する Google Maps API の使用制限をよく理解することをお勧めします。

Google Maps API プレミアム プランは購入するべきですか?

ビジネスや組織で以下のいずれかが必要な場合は、Google Maps API プレミアム プランをご購入いただくことをお勧めします。

  • 24 時間のテクニカル サポートが組み込まれた SLA
  • Google マップが埋め込まれた製品またはサービスの販売
  • 社内のアプリケーションまたはウェブサイトでの Google Maps API の使用
  • 特定の量の割り当て
  • 既存の Maps API for Work ライセンスで利用できるプレミアム機能

Google Maps API プレミアム プランを購入するにはどうすればよいですか?

Google Maps API プレミアム プランの購入の詳細およびアプリケーションの推定使用量に基づく価格見積もりについては、Google の営業担当者にお問い合わせください。

ウェブサービス API を使用している場合は、1 日あたり 2,500 回のリクエストが無料です。無料割り当てを超えた場合は、自動課金に登録していれば、1 日のリクエストが 100,000 回に達するまで従量課金割り当てを利用できます。

Google Maps JavaScript API、Google Static Maps API、または Google Street View Image API を使用している場合は、何もありません。マップは動作を続けます。使用量が短期間に急増するサイトに対応するため、使用制限は、サイトが使用制限を 90 日連続して超えた場合にのみサイトに適用されます。

超過使用量はどのように計算され、課金されるのですか?

各 Google Maps API サービスの無料の割り当てを超える使用量は、1 日の最後に計算されます。

ウェブサービス API では、1 日あたり 2,500 回のリクエストが無料です。課金を有効化して割り当てを増やすと、1 日あたり 2,500 回のリクエストを超過した際に 1,000 回の追加リクエストごとに $0.50 USD が課金されます。この場合、1 日あたりの最大数は、100,000 回までとなります。

Google Maps JavaScript API、Google Static Maps API、および Google Street View Image API では、1 日あたり 25,000 回のマップのロードが無料です。サイトで 1 日の超過使用が 90 日以上続く場合、Google から支払いオプションについてご連絡を差し上げます。

使用制限を超えた場合はどうなるかについて詳細をご覧ください。

課金を有効にする場合は、クレジット カードの詳細を入力していただく必要があります。超過使用は引き続き 1 日の最後に計算され、毎月末に入力されたクレジット カードに課金される合計金額は、のように決定されます。

Google Maps API の使用コストはどれくらいですか?

生成するリクエストまたはマップのロード ボリュームが使用制限未満であるアプリケーションは、無料で Google Maps API を使用できますが、アプリケーションが Google Maps API の利用規約要件を満たしている場合に限ります。

ウェブサービス API では、Maps API サービスが 1 日あたりの使用制限を超えたために Google デベロッパー コンソールを使用して超過割り当てをオンラインで購入する場合、超過使用は、次に示す該当サービスのレートで課金されます。

Google Maps JavaScript API v3、Google Static Maps API、および Google Street View Image API では、Maps API サービスの使用量が 1 日あたりの使用制限を 90 日連続して超えたために Google デベロッパー コンソールを使用して超過マップロードをオンラインで購入する場合、超過使用は、次に示す該当サービスのレートで課金されます。

サイトの 1 日のマップのロード ボリュームが常に高い場合は、Google Maps API for Work ライセンスのほうがコスト効果が高くなる可能性があります。詳細については、Google Maps API for Work 営業チームにお問い合わせください。

ウェブサービス API 使用制限
(1 日あたり)
1000 回の超過リクエスト
(米国ドル)
Directions API 2,500 $0.50
Distance Matrix API 1 2,500 $0.50
Elevation API 2,500 $0.50
Geocoding API 2,500 $0.50
Geolocation API 2,500 $0.50
Roads API 2,500 $0.50
Time Zone API 2,500 $0.50
1 Google Maps Distance Matrix API の使用量は、1 日あたりの要素数に基づいて測定されます。
ウェブ API 使用制限
(1 日あたり)
1000 回の超過マップロード
(米国ドル)
Google Maps JavaScript API 25,000* $0.50
Google Static Maps API 25,000* $0.50
Google Street View Image API 25,000* $0.50
* 課金は、使用制限を 90 日連続して超えた場合にのみ発生します。

超過割り当てをオンラインで購入しても、既存の利用規約に従って Google Maps API を引き続き使用する権利以外に、追加の権利または特典が得られるわけではありません。

他の通貨での価格設定はありますか?

価格設定は、現在は米国ドルのみです。

課金を有効にしました。請求額を表示するにはどうしたらよいですか?

Google は、指定されたお支払い方法に基づき、毎月月初に前月のアクティビティに対して課金を行います。

使用量が予期せず増加した場合に請求額を抑えるにはどうしたらよいですか?

Google Maps API では、1 日あたりの無料割り当てが用意されており、1 日に請求可能な上限額が設定されます。予期せず使用量が増加した場合に備えて、使用量に関する 1 日の上限を定めておくことができます。課金アカウントへの課金が設定したしきい値に達したときにメール通知を受信するように課金アラートを設定することもできます。

1 日に請求可能な上限額の設定:

  • ウェブサービス API の場合:

    標準のウェブサービス API では、1 日あたり最大で 100,000 のリクエストまたは要素がサポートされています。プロジェクトに対して課金を有効化するまでは、無料で使用できる 1 日あたり最大 2,500 の制限がプロジェクトに適用されます。課金を有効化すると、1 日あたり 2,500 回のリクエストを超過した際に 1,000 回の追加リクエストごとに $0.50 USD が課金されます。この場合、1 日あたりの最大数は、100,000 回までとなります。

    請求額を抑えるために、予期せず使用量が増加した場合に備えて、使用量に関する 1 日の上限を定めておくことができます。現在、デフォルトでは、1 日あたり 100,000 回のリクエストが課金上限となっています。Google Developers Consoleのこの API の [Quotas] ページで、[Total quota] の隣にある編集アイコンをクリックすると、この制限を変更できます。

    注:API の使用制限が課金上限に達した場合、その日が終わるまでアプリケーションは API にアクセスできなくなります。詳細については、使用制限を超えた場合はどうなりますか?をご覧ください。

  • ウェブ API の場合:

    Google Maps JavaScript API v3Google Static Maps API、および Google Street View Image API では、サイトで 1 日あたり 25,000 回のマップロードという無料の使用制限を 90 日連続して超えるまでは API の使用制限は有効になりません。標準の Google Maps ウェブ API の使用が無料の使用制限を超えた場合は、プロジェクトに対して課金を有効化して超過マップロードをオンラインで購入できます。課金を有効化すると、無料の使用制限を超過した際に 1,000 回の追加リクエストごとに $0.50 USD が課金されます。この場合、1 日あたりの最大数は、1,000,000 回までとなります。

    請求額を抑えるために、課金の開始後に予期せず使用量が増加した場合に備えて、使用量に関する 1 日の上限を定めておくことができます。現在、デフォルトでは、1 日あたり 1,000,000 回のリクエストが課金上限となっています。Google Developers Consoleのこの API の [Quotas] ページで、[Total quota] の隣にある編集アイコンをクリックすると、この制限を変更できます。

    注:API の使用制限が課金上限に達した場合、その日が終わるまでアプリケーションは API にアクセスできなくなります。詳細については、使用制限を超えた場合はどうなりますか?をご覧ください。

課金アラートの設定と管理:

課金アカウントへの課金が設定したしきい値に達したときに課金管理者にメール通知を送信するように課金アラートを設定します。課金管理者にメール通知が送信されるのは、課金アカウントへの推定課金額がしきい値の 50%、90%、および 100% を超えた場合です。

推奨事項:サイトの 1 日のリクエストまたはマップのロードのボリュームが常に高い場合は、Google Maps API for Work ライセンスのほうがコスト効果が高くなる可能性があります。詳細については、Google Maps API for Work 営業チームにお問い合わせください。

課金の有効化

Google Maps API の課金を有効にして、割り当て制限を解除するには、Google デベロッパー コンソールで次の作業を行います。

  1. プロジェクトを作成または選択する
  2. 課金プロファイルの設定や選択を行う
  3. プロジェクトの課金を有効にする
続ける

Google Maps API の使用

各種マップ製品に使用する必要があるキーまたは資格情報は何ですか?

Google Maps API を使用するたびに、キーまたはその他の資格情報を使用してリクエストを検証する必要があります。必要な資格情報のタイプは、API や所有しているライセンス(標準ライセンスまたはプレミアム ライセンス)によって異なります。

Google Maps API は、Android、iOS、またはウェブアプリ、HTTP 経由のウェブサービスで使用できます。Maps ファミリーの API では、特定の製品のロードまたは使用時に渡す必要があるさまざまな資格情報を使用します。使用する資格情報は、製品によって異なります。

  • API キー:API キーは、Google Developers Consoleを使用して生成する一意の識別子です。API キーは、通常は標準 API で使用されます。プレミアム ユーザーは、一般的に API キーではなくクライアント ID を使用します。

    各プラットフォームの API には、特定のタイプのキーが必要です。次の 4 つのタイプのキーを使用できます。

    同じプラットフォームの API では、同じキーを使用できます。

    注: Google Maps API for Work およびプレミアム ユーザーは、サインアップ時に生成されたプロジェクトを選択する必要があります。このプロジェクトの名前には Business または Work という語が含まれます。

    キーを使用した API のロード例: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

  • クライアント ID:クライアント ID は、Google Maps API for Work またはプレミアム ユーザーとしてサインアップしたときに与えられます。

    クライアント ID を使用した API のロード例: &client=gme-companyname

  • デジタル署名:デジタル署名を使用するのは、Google Maps API for Work とプレミアム ユーザーのみです。デジタル署名は、Google から提供された暗号化キーを使用して生成する必要があります。詳細については、Google Maps API for Work ウェブサービスのドキュメントをご覧ください。

次の表に、各マップ製品で使用する必要があるキーまたは資格情報を示します。

API 標準ユーザー プレミアム ユーザー
Google Maps Android API Android キー Android キー
Google Places API for Android Android キー 使用不可
Google Maps SDK for iOS iOS キー iOS キー
Google Places API for iOS iOS キー 使用不可
Google Maps JavaScript API ブラウザキー クライアント ID
Google Static Maps API ブラウザキー クライアント ID + デジタル署名
Google Street View Image API ブラウザキー クライアント ID + デジタル署名
Google Maps Embed API ブラウザキー 使用不可
Google Maps Directions API サーバーキー クライアント ID + デジタル署名
Google Maps Distance Matrix API サーバーキー クライアント ID + デジタル署名
Google Maps Elevation API サーバーキー クライアント ID + デジタル署名
Google Maps Geocoding API サーバーキー クライアント ID + デジタル署名
Google Maps Geolocation API サーバーキー サーバーキー
Google Maps Roads API サーバーキー サーバーキー
Google Maps Time Zone API サーバーキー クライアント ID + デジタル署名
Google Places API Web Service サーバーキー サーバーキー

注:Google Maps JavaScript API、Google Static Maps API、Google Street View Image API、Google Maps Geocoding API、Google Maps Directions API、Google Maps Distance Matrix API、Google Maps Elevation API、Google Maps Time Zone API の各 Maps API では、以前は API コンソール キーが不要でした。これは、下位互換性を確保するためにレガシー アプリケーションではまだサポートされていますが、新しいアプリケーションでは推奨されていません。

キータイプをブラウザキーからサーバーキーに切り替えるにはどうすればよいですか?

重要:ブラウザキーでウェブサービス API を使用すると、2015 年 9 月 1 日以降、リクエストが失敗し、「This IP, site or mobile application is not authorized to use this API key.」というエラー メッセージが表示される可能性があります。サーバーキーに切り替える必要があります。

API キータイプを切り替えるには、少なくとも 1 つのサーバーキーが必要です。同じプラットフォームの API では、同じキーを使用できます。API キーは、Google Developers Consoleから取得します。

ウェブサービス APIサーバーキーを取得するには、次の操作を実行します。

  1. Google デベロッパー コンソールにアクセスします。
  2. プロジェクトを選択または作成します。
  3. 新しい API キーを作成するには、[Add credentials] ボタンをクリックします。
  4. 資格情報タイプのリストから [API key] を選択します。
  5. [Create a new key] ポップアップで、[Server key] ボタンを選択します。
  6. サーバーキーの名前を指定し、必要な IP アドレス制限(オプション)を設定して [Create] をクリックします。
  7. 新しいサーバーキーが生成され、資格情報ページに表示されます。リスト内のキーはタイプで識別されます。

ウェブサービス API リクエストでサーバーキーを指定する

リクエストで新しいサーバーキーを指定するには、キーを key パラメータの値として含めます。

例:

Elevation API の場合:

https://maps.googleapis.com/maps/api/elevation/json?locations=39.739,-104.984&key=YOUR_API_KEY

Geolocation API の場合:

https://www.googleapis.com/geolocation/v1/geolocate?key=YOUR_API_KEY

次のエラーを解決するにはどうすればよいですか?「This IP, site or mobile application is not authorized to use this API key.」

このエラーは、さまざまなシナリオで発生する可能性があります。

  • ブラウザキーでウェブサービス API を使用している。

    ウェブサービス API ではサーバーキーを使用する必要があります。キータイプをブラウザキーからサーバーキーに切り替えてください

  • サーバーキーに対して IP アドレス制限を有効にし、許可されていない IP アドレスがリクエストを試行している。
  • ブラウザキーに対して HTTP リファラー制限を有効にし、許可されていないリファラがリクエストを試行している。
  • パッケージ名とフィンガープリントを設定して使用を Android アプリに制限し、許可されていない Android アプリがリクエストを試行している。
  • バンドル識別子を指定して iOS アプリからのリクエストを制限し、許可されていない iOS アプリがリクエストを送信しようとしている。

API キーの資格情報を表示および編集する

API キーと追加された制限を表示するには、次の操作を実行します。

  1. Google Developers Console に移動します。
  2. [Project] ドロップダウンから、確認する API キーが含まれているプロジェクトを選択します。
  3. キーに設定された制限などの資格情報の詳細を表示するには、API キーのリストでキーの名前をクリックします。
  4. キーに設定された制限など、選択した API キーのすべての資格情報が表示されます。ここで必要に応じて制限を削除または更新できます。

Google Maps API の各バージョンで加えられた変更を調べるにはどうすればよいですか?

Google Maps JavaScript API バージョン間の変更内容のリストは、次の場所にあります。

https://developers.google.com/maps/documentation/javascript/releases

特定のバグが見つかって修正された Google Maps API のバージョンは、次の場所にある Google Maps API Issue Tracker を使用して確認することもできます。

http://code.google.com/p/gmaps-api-issues/issues/list

ページのロード後に API を非同期にページにロードするにはどうすればよいですか?

API をロードするときに callback パラメータを指定するだけです。詳細およびサンプルコードは、Maps API のドキュメントのスタートガイドの章をご覧ください。

Google Maps API で英語以外の言語で表示するにはどうすればよいですか?

デフォルトでは、API はユーザーの場所またはブラウザ設定に基づいて最も適切な言語をロードしようとします。リクエスト時に言語を明示的に設定できる API もあります。言語の設定方法の詳細については、各 API のドキュメントをご覧ください。

サポートされている言語
言語コード 言語 言語コード 言語
ar アラビア語 kn カンナダ語
bg ブルガリア語 ko 韓国語
bn ベンガル語 lt リトアニア語
ca カタロニア語 lv ラトビア語
cs チェコ語 ml マラヤーラム語
da デンマーク語 mr マラーティー語
de ドイツ語 nl オランダ語
el ギリシャ語 no ノルウェー語
en 英語 pl ポーランド語
en-AU 英語(オーストラリア) pt ポルトガル語
en-GB 英語(英国) pt-BR ポルトガル語(ブラジル)
es スペイン語 pt-PT ポルトガル語(ポルトガル)
eu バスク語 ro ルーマニア語
eu バスク語 ru ロシア語
fa ペルシャ語 sk スロバキア語
fi フィンランド語 sl スロベニア語
fil フィリピン語 sr セルビア語
fr フランス語 sv スウェーデン語
gl ガリシア語 ta タミル語
gu グジャラート語 te テルグ語
hi ヒンディー語 th タイ語
hr クロアチア語 tl タガログ語
hu ハンガリー語 tr トルコ語
id インドネシア語 uk ウクライナ語
it イタリア語 vi ベトナム語
iw ヘブライ語 zh-CN 中国語(簡体字)
ja 日本語 zh-TW 中国語(繁体字)

マップが選択した言語でどのように表示されるかは、サンプル アプリケーションで確認できます。

Google Maps API に SSL(HTTPS)経由でアクセスできますか?

デベロッパーは、Google Maps JavaScript API、Google Static Maps API、および Google Maps API Web Service にこれらの API の無料版または Google Maps API for Work を使用してセキュアな(HTTPS)接続経由でアクセスできます。SSL 経由で API にアクセスする方法の詳細については、該当する API のドキュメントをご覧ください。

Google Static Maps API では、HTTPS を使用するカスタム アイコン URL はサポートされていません。そのため、デフォルトのアイコンが表示されます。

Google Maps API のバグを報告したり新機能をリクエストしたりするにはどうすればよいですか?

バグの可能性がある動作が見つかった場合は、まず関連するフォーラムで提起してください。これにより、他のデベロッパーがバグを検証し、コードの潜在的な問題を排除できます。

機能をリクエストする場合も、まず関連するフォーラムで提起し、要件を満たすソリューションがまだ利用できないことを確認してください。

新しいバグを特定した場合、または Google Maps API の既存の機能では要件が満たされないことを確認した場合は、Google Maps API Issue Tracker を使用してバグまたは機能リクエストを報告してください。

バグまたは機能リクエストを Issue Tracker に追加する前に、該当するバグまたは機能がまだ追加されていないことを確認してください。追加されている場合は、問題に星を付けて関心があることを登録すると、アップデートが通知されます。

このエラーの意味は何ですか?

Google Maps JavaScript API のロード中にエラーが発生した場合は、エラー メッセージに記載されたエラーコードの説明をご覧ください。

別の質問または問題があります。誰に問い合わせたらよいですか?

Google のデベロッパー リレーションズ チームは、Stack Overflow で質問や問題を管理しています。Stack Overflow は、参加編集型のプログラマー向け Q&A サイトです。Google マップ アプリケーションの開発やメンテナンスに関する技術的な質問を行う場所として活用することをお勧めします。Stack Overflow での質問の投稿の詳細については、サポートのページをご覧ください。

支援を求めるときに最高の結果が得られるように、次の点を念頭に置いてください。

  • 現在のディスカッションを検索します。同様の問題が発生した人や解決方法を見つけた人がいる可能性があります。
  • 可能であれば、サイトへのリンクを送信します。コードをオンラインで簡単に表示できない場合は、コード スニペットのみを投稿してください。
  • ブラウザ バージョン、エラー、この問題のトラブルシューティングに役立つ可能性がある他のあらゆる事実など、関連する情報をすべて提供してください。

Google Maps API for Work ユーザーは、Google for Work のサポートに問い合わせることもできます。

Google Maps API サービス

住所を緯度と経度のペアに変換する必要があります。Google Maps API で変換できますか?

はい。このプロセスは「ジオコーディング」と呼ばれます。各 Google Maps API には、ジオコーディングを実行するためのクラスがあります。これらのクラスは次のとおりです。

Google は、ジオコーディング ウェブサービスも提供しています。このサービスは、JSON 形式や XML 形式で応答できる REST インターフェースを提供します。

ジオコーダ リクエストに適用される使用制限に注意してください。また、Google Maps API を使用して表示される場所を取得する以外の目的でジオコーダを使用すると、利用規約に違反したことになるので注意してください。HTTP ジオコーダを使用して Google Maps API アプリケーション以外で住所をジオコーディングし、住所をキャッシュして後でいずれかの Google Maps API を使用して表示できます。ただし、ジオコーディング ウェブサービスを使用して取得された場所は、他の手段で配布されたか再販売された他のアプリケーションでは使用できません。

ジオコーディングを使用できる国はどこですか?

Google Maps API ジオコーダで現在サポートされている国については、Google マップの対象データをご覧ください。

ジオコーディングされた場所の精度は、国によって異なる場合があります。そのため、返される location_type フィールドを使用して、アプリケーションの目的に十分合う一致が見つかったかどうかを確認してください。ジオコーディング データの可用性は、Google とデータ プロバイダの関係に依存するため、変わる可能性があります。

Google Maps API で現在サポートされていない国でのジオコーディングについては、他のジオコーディング サービスのリストをご覧ください。

Google Maps API ジオコーダが Google マップとは異なる場所を示すのはなぜですか?

API ジオコーダと Google マップ ジオコーダは、(国によって)使用するデータセットが異なることがあります。API ジオコーダは新しいデータで更新されることがあるため、時間の経過に伴って結果が変更されたり改善されたりする可能性があります。

成功するリクエストの数を最大にするには、ジオコーダ クエリをどのようにフォーマットすればよいですか?

ジオコーダは、番地を地理的座標にマッピングするように設計されています。そのため、クエリが成功する可能性を最大限にするには、次のガイドラインに従ってジオコーダ リクエストをフォーマットすることをお勧めします。

  • 対象国の郵便業務で使用されている形式で住所を指定します。
  • 店名、組織名、階数、部屋番号など、対象国の郵便業務で定義されている住所に含まれないその他の住所の要素は指定しないでください。
  • 可能な限り、建物名よりも建物の番地を指定します。
  • 可能な限り、交差点を指定するよりも、番地指定を使用します。
  • 周辺の目標物などの「ヒント」は指定しません。

米国の番号付き高速道路上の住所をジオコーディング用にフォーマットするにはどうすればよいですか?

Google Maps API ジオコーダでは、米国の番号付き高速道路を次のように住所で指定する必要があります。

  • 郡道:"Co Road NNN"NNN は道路番号です。例:"Co Road 82"
  • 州道:"State NNN"State は州の完全な名前、NNN は高速道路番号です。例:"California 82"
  • 米国高速道路:"U.S.NNN"NNN は高速道路番号です。例:"U.S.101"
  • 米国州間高速道路:"Interstate NNN"NNN は州間高速道路番号です。例:"Interstate 280"

どのようなときに API ジオコーダ クラスを使用し、どのようなときに HTTP ジオコーディング サービスを使用すべきですか?

記事のジオコーディング方法をご覧ください。さまざまなジオコーディング方法の良い点と悪い点が詳しく記載されています。

Google Maps API で運転ルートを提供するにはどうすればよいですか?

Google Maps JavaScript API では、google.maps.DirectionsService クラスを使用して運転ルートを提供できます。このクラスを使用すると、基本的な運転ルートや複数地点の運転ルートにステップ バイ ステップでアクセスできます。DirectionsRenderer クラスは、オーバーレイとルートパネルを自動的に作成できます。追加の例がドキュメントに記載されています。

運転ルートの Google マップに簡単にリンクすることもできます。Google マップ上の運転ルートには、次の形式を使用することをお勧めします。

http://maps.google.com/maps?saddr={start_address}&daddr={destination_address}

運転ルートを使用できる国はどこですか?

Maps API の運転ルートで現在サポートされている国については、Google マップの対象データをご覧ください。運転ルートデータの可用性は、Google とデータ プロバイダの関係に依存し、変わる可能性があります。

交通機関のルートを使用できる国はどこですか?

Google マップのルートサービスでは、交通機関の対象リストに記載されているすべての交通機関(日本を除く)をサポートしています。

Google Maps JavaScript API でサポートされている KML と GeoRSS の機能は何ですか?

Javascript API の KmlLayer クラスを使用すると、デベロッパーは KML/KMZ ファイルと GeoRSS ファイルをマップ上でオーバーレイできます。例はここにあります。

KmlLayer クラスで現在サポートされている KML 機能は、次の場所に記載されています。

https://developers.google.com/kml/documentation/mapsSupport

Google Maps JavaScript API の KmlLayer クラスを使用して表示できる KML のサイズと複雑さの制限は何ですか?

KmlLayer クラスを使用した KML の表示に関するサイズと複雑さの制限については、次をご覧ください。

https://developers.google.com/kml/documentation/mapsSupport

Google Static Maps API でサポートされているマーカーまたは経路の頂点の最大数はいくつですか?

Google Static Maps API でサポートされているマーカーまたは経路の頂点の数に制限はありません。カスタム アイコンを使用する場合は、一意のアイコンをリクエストごとに 5 個まで指定できますが、それぞれをマップ内で複数回使用することもできます。

Google Static Maps API URL には、最大約 2,000 文字を使用できます。これには、緯度と経度の各ペアを指定するときに使用される小数点以下の桁数に基づいて指定できるマーカーと経路の頂点の数が含まれます。使用される小数点以下の桁数が地球上の精度とどの程度関連しているかについては、Decimal Degrees(10 進経緯度)に関する Wikipedia の記事をご覧ください。

中国から Google Maps API にアクセスできないのはなぜですか?

Google Maps API は、中国ではドメイン maps.google.cn から提供されています。このドメインでは、https をサポートしていません。中国から Google Maps API にリクエストする場合は、https://maps.googleapis.comhttp://maps.google.cn に置き換えてください。

次に例を示します。

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA

これを次のように変更します。

http://maps.google.cn/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA

Google Maps JavaScript API は、次のブートストラップでロードできます。

<script src="http://maps.google.cn/maps/api/js?key=YOUR_API_KEY"
type="text/javascript">
</script>

フィードバックを送信...