FAQ(2011/10/27版)

Google 公式日本語ドキュメントが更新されるまでの個人的な暫定訳です。参考程度にしてください。

※訳が違っていても保証しません。転載したり、このページへリンクして紹介した場合でも、一切責任を負いません。

使い始るために

  • Google Maps APIとは?
  • Google Maps APIはどの国をカバーしていますか?
  • 私のサイトにGoogle Maps APIを使わないでGoogleマップを置いてもいいですか?
  • どうやってモバイル端末に地図アプリケーションを配布したらいいですか?
  • Google Maps JS APIはどのブラウザをサポートしていますか?
  • どのツールとどのFlashプレイヤーがGoogle Maps API for Flashをサポートしていますか?
  • Google Maps APIを私のサイトで使うにはどうしたらよいでしょう?
  • Google Maps APIの変更を知るにはどうしたらよいでしょうか?

利用規約を理解する

  • Google Maps API 利用規約(Terms of Services)とは何ですか?
  • 私のサイトはGoogle Maps APIの利用規約に抵触しますか?
  • 地図画像と航空写真画像に直接アクセスしてもよいでしょうか。
  • 商用のサイトでGoogle Maps APIを使うことは可能ですか?
  • トラッキングアプリケーションでGoogle Maps APIを使うことは出来ますか?
  • WebアプリケーションではないときにGoogle Maps APIを使うことは可能ですか?
  • パスワードで保護されたサイトでGoogle Maps APIを使うことは可能ですか?
  • 何の情報をGoogle Maps APIに報告しなければなりませんか?
  • 印刷物やオフラインメディアでGoogle Maps APIアプリケーションのスクリーンショットを使ってもよいでしょうか。
  • Google検索の結果に私のコンテンツを含めないようにすることは出来ますか?
  • JavaScript Maps APIを使うとき、何の情報がGoogleに送信されますか?
  • Google Static Maps APIを使って画像を生成し、それを保存して私のサイトから利用することは出来ますか?

使用量制限について

  • Maps APIに適用される使用量制限とは何ですか?
  • 私のサイトは大量のトラフィックがあります(とても人気なサイトです)。Google Maps APIを使うことは出来ますか?
  • Maps APIに適用される使用量制限の”地図のロード”の構成は何ですか?
  • もし私のサイト or アプリケーションが突然人気になったら、地図は動かなくなってしまうのでしょうか。
  • 地図ロードの超過使用量のオンラインコストはいくらですか?
  • 私が送信できるジオコーディングの数のリミットはありますか?

Google Maps APIの使い方

  • Google Maps APIキーのシステムはどのように機能しますか?
  • 複数のドメインでホストして利用しているとき、どうやって私のアプリケーションは有効なAPIキーを使うように設計したら良いでしょうか。
  • Google Maps APIの各バージョンの変更の概略を知るにはどうすればいいですか?
  • v=2, v=2.x または v=2.sを指定した時、どのバージョンのGoogle Maps APIが現在使われていますか?
  • google.maps.* 名前空間でAPIをロードするにはどうしたらよいでしょう。
  • ページが読み込まれたあとに非同期にAPIをロードするにはどうすればいいですか?
  • Google Maps APIで英語以外を表示することはできますか?
  • 異なる文字エンコーディングでGoogle Maps APIを出力することは出来ますか?
  • SSL(HTTPS)を使ってGoogle Maps APIにアクセスすることは出来ますか?
  • SSL(HTTPS)でホストされるサイトでGoogle Maps API for Flashアプリケーションは利用することができますか?
  • Flash APIの中でBitmapData.draw/3Dエフェクトを使うとどうしてセキュリティ・サンドボックス・エラーになるのでしょうか。
  • Google Maps APIのバグや新機能のリクエストは、どうやって報告することができますか?
  • 私はこれらとは違う質問や問題があります。誰に連絡したらよいでしょうか。

Google Maps API サービス

  • 住所を緯度経度のペアに変換しなければならないのですが、Google Maps APIを使ってできますか?
  • どの国でジオコーディングは利用可能ですか?
  • どうしてGoogle Maps APIジオコーダーはGoogle Mapsとは違う位置を返すのでしょうか。
  • どのようにジオコーディングするために、ハイウェイ上のアメリカの住所を形式化するべきですか?
  • ジオコーダーのレスポンスのAccuracy(精度)とはどういう意味でしょう。
  • ジオコーダーのクエリを最大限成功するようにするにはどういう形式にするべきでしょうか。
  • どのようなときAPIジオコーダークラスを使うべきで、どのようなときHTTPジオコーディングサービスを使うべきですか?
  • Google Maps APIを使ってルート案内を提供するにはどうしたらできますか?
  • どの国でルート検索を利用することができますか?
  • KML と GeoRSSのどの機能がGoogle Maps Javascript APIでサポートされていますか?
  • Google Maps Javascript APIのKmlLayerクラスを使って、どれだけのサイズと複雑なKMLを表示することができますか?
  • Google Static Maps APIでサポートされているマーカーやパスの頂点の最大数はいくつですか?

あなたの地図上の広告

  • 私の地図上に広告を含めてもいいですか?
  • 地図上の広告からどれだけの収入を稼ぐことができますか?
  • 私のAdSense publisher IDはどうやって見つけることができますか?
  • AdSenseチャネルとは何でしょうか。
  • どの国でadsレイヤーを使った広告は利用できますか?
  • 私はadsレイヤーを使っているのですが地図上にadマーカー(広告マーカー)が表示されません。何が間違っていますか?

Google Maps APIとは?

Google Maps APIはディベロッパーにいくつかの方法でGoogleマップをWebページに埋め込む方法を提供していて、単に埋めこんだり、拡張してカスタマイズして利用することができます。現在提供しているAPIは次の通りです。

あなたのニーズによって、どのAPIを選ぶか、またはこれらのAPIを組み合わせて使うかを決めることができます。

エンタープライズか商用的なウェブサイトで使いたい場合には、Google Maps API Premier に興味があるかもしれません。 

Google Maps APIはどの国をカバーしていますか?

Google Mapsチームは定期的に新しい地図データを利用できるようにし、世界的なカバーの範囲を広げています。このスプレッドシートはカバー状況の最新の詳細な状況を示しています。スプレッドシートの上部にあるドロップダウンリストを使って絞り込むことができます(例.ルート検索の利用できる全ての国を見るには、driving directionを"yes"をドロップダウンリストから選びます)。データプロバイダーとの契約変更によりデータのカバー状況は変化することに注意してください。

こちらをご覧ください: Map Coverage Details Spreadsheet
こちらも参照してください: Supported Languages Spreadsheet.

私のサイトにGoogle Maps APIを使わないでGoogleマップを置いてもいいですか?

はい。Google Maps はあなたのウェブサイトやブログにGoogle Maps APIを使わないで埋め込むことができる方法を提供しています。詳しい利用方法はこちら。

どうやってモバイル端末に地図アプリケーションを配布したらいいですか?

Google Maps JavaScript API V3 はモバイル端末を考慮してあり、Apple iPhoneのようなJavaScriptがフル実装されたウェブブラウザを持つ端末とデスクトップで快適に動くように開発されています。

JavaScript APIが快適に動かない端末では、Static Maps API を使ってGIF, JPG, そしてPNG形式による、マーカーやポリラインを含んだ地図の配信が利用できます。ブラウザではない環境で動くアプリケーションでStatic Maps APIを利用する場合には、地図画像をGoogle Mapsにリンクさせなければなりません。

Androidアプリケーションに地図を実装するには、Android Maps External Libraryをご利用ください。

ネイティブiPhoneアプリケーションに地図を実装するには、Apple iPhone Map Kit framework をご利用ください。

Google Maps JS APIはどのブラウザをサポートしていますか?

Google Maps JavaScript APIは、次のウェブブラウザをサポートしています。

Google Maps JavaScript API V3:

  • IE 7.0+ (Windows)
  • Firefox 3.0+ (Windows, Mac OS X, Linux)
  • Safari 4+ (Mac OS X, iOS)
  • Chrome (Windows, Mac OS X, Linux)
  • Android
  • BlackBerry 6
  • Dolfin 2.0+ (Samsung Bada)

Google Maps JavaScript API V2:

  • IE 6.0+ (Windows)
  • Firefox 2.0+ (Windows, Mac OS X, Linux)
  • Safari 3.1+ (Mac OS X, iOS)
  • Chrome (Windows)
どのツールとどのFlashプレイヤーがGoogle Maps API for Flashをサポートしていますか?

Google Maps API for Flashは、Flash Player 9 安定版(9.0.151.0)以上をサポートしています。

公式的にサポートしている開発ツールは、Flex Builder 3, Adobe Flash CS3, と the Flex 3 SDKです。

Google Maps APIを私のサイトで使うにはどうしたらよいでしょう?

Maps Javascript API documentation の例と詳細をご覧ください。

Google Maps APIの変更を知るにはどうしたらよいでしょうか?

Google Geo ディベロッパーが様々なニュースアップデートを提供する Google Geo Developers Blog のブログをご覧ください。

新機能のようなアプリケーションに影響するかもしれない変更を知るには、これらの関連するGoogle Groupもご利用ください。


Google Maps API 利用規約(Terms of Services)は何ですか?

Google Maps APIの利用規約は、こちらをご覧ください。

http://www.google.com/apis/maps/terms.html

Google Maps API Premierの利用規約は、こちらです。

https://support.google.com/enterprise/doc/gme/terms/maps_purchase_agreement.html

私のサイトはGoogle Maps APIの利用規約に抵触しますか?

課金することなく消費者がアクセスすることができる全てのサイトでMaps APIは利用することができます。商用的でも非営利なサイトでもあなたが Terms of Service に適合するかぎり利用することができます。

しかしながら、いくつかのGoogle Maps APIの使い方はしてほしくありません。例えば市内のどこで非合法な薬を買うことが出来るか、その他、非合法的な活動など。また私達は人々のプライバシーを尊重するので、個人のプライバシー情報を特定するような使い方にGoogle Maps APIを使うべきではありません。

あなたはあなたの個人の判断のもとに、開発や公開をするまえに Terms of Service とあなたのアプリケーションを比較して決めてください。Googleエンジニアは技術的な補助のみ提供し、法的なアドバイスについては応える立場にありません。Googleはいつでも突然にあなたが利用するサービスを停止する権利を保持しています。Terms of Service を注意深くお読みください。

もしエンタープライズや商用的なサイトを運営しているのであれば、あなたのニーズにより適しているように変更されている Google Maps API Premier の Terms of Service のが適しているかもしれません。

地図画像と航空写真画像に直接アクセスしてもよいでしょうか。

Google Maps APIにどんなメカニズムを加えて使用しても、地図や衛星画像に直接アクセスすることは認められていません(例えば直接マッピングするAPIやタイルを一括ダウンロードスクリプトなど)。もしGoogle Maps APIを通さずにあなたのアプリケーションがタイルにアクセスする場合はブロックされます。 Google Terms of Use の5.3章に詳細がありますのでご覧ください。

商用のサイトでGoogle Maps APIを使うことは可能ですか?

課金なく普通に消費者があなたのサイトにアクセスできるかぎり、あなたはGoogle Maps APIを利用できるでしょう。例えば、もしあなたのサイトが広告によってサポートされていても、Google Maps API Terms of Service に適合するでしょう。もしあなたが情報をあなたの地図上に配置するのに課金する場合(例えば家の販売のリストを掲載するなど)、しかしGoogle Maps APIを使って情報を表示する部分があなたのサイトの無償の部分なら、Google Maps API Terms of Serviceに適合します。

しかしながら、全ての商用的なサイトで使って良いわけでありません。例えば、もしあなたのサイトが次の基準に抵触する場合、適した Google Maps API Premier ライセンスを購入しなければなりません。

  • あなたのサイトが有償会員しか利用できない
  • あなたのサイトが会社内やイントラネット上でしかアクセス出来ない
  • あなたのアプリケーションがエンタープライズとして、集中管理、ビジネス資産トラッキングや似たようなアプリケーションとして発売される

Googleは常に突然、あなたのGoogle Maps APIの使用を停止する権利を保持していることを思い出してください。Terms of Service を注意深くお読みください。

トラッキングアプリケーションでGoogle Maps APIを使うことは出来ますか?

無償公開されているデータでTerms of Serviceを順守しているならGoogle Maps APIを使ってリアルタイムトデータ(トラッキング)をすることを制限するものはないです。内部的に利用されるアプリケーションの場合は、Google Maps API Premier を使わなければなりません。 Terms of Service  Section 10.9  に詳細がありますのでご覧ください。

WebアプリケーションではないときにGoogle Maps APIを使うことは可能ですか?

はい、Google Maps APIsは現在、Terms of Serviceの他の項目も固守するデスクトップアプリケーションなら利用することができます。公開アクセスできるデスクトップアプリケーション向けであり、それらは公開されたウェブページでダウンロードできなければなりません。Terms of ServiceのSection 7.1c に詳細がありますのでご覧ください。

パスワードで保護されたサイトでGoogle Maps APIを使うことは可能ですか?

はい、ですがパスワードで保護されたウェブサイトでGoogle Maps APIを使用する前に Terms of Service をよく調べてください。もし消費者が課金されることなく簡単にサインアップできる、または公開利用できる地図をパスワードで保護する目的(例:管理者)ならば、あなたのサイトはTerms of Serviceの範囲内でしょう。もしそうでないケースではGoogle Maps API Premierを使う必要があるでしょう。

何の情報をGoogle Maps APIに報告しなければなりませんか?

Terms of Service の Section 9.2には、開発者はMaps APIの実装がセンサーを使ってユーザーのデバイスを地図上に特定するかどうかを報告しなければなりません。例えば、Google Gearの Geolocationモジュールは緯度経度を使用者にWIFI/GPS/Cell IDに基づて提供します。

各Maps APIのsensorを使った報告の方法は、以下のとおり。

印刷物やオフラインメディアでGoogle Maps APIアプリケーションのスクリーンショットを使ってもよいでしょうか。

印刷物やオフラインメディアでの使用は、Permission Guidelinesで公開されています。

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

Google検索の結果に私のコンテンツを含めないようにすることは出来ますか?

私たちはこのデータをもう集めていません。indexing パラメータは廃止され、効果はありません。あなたは明示的に義務を逃れる必要はありません。ですが、このパラメータを早く取り外すことをお勧めします。

検索結果からあなたのページやサイトを削除するには、ウェブマスターヘルプセンターの instructions に従ってください。

JavaScript Maps APIを使うとき、何の情報がGoogleに送信されますか?

JavaScript Maps APIを利用するとき、次の情報がGoogleに送信されます。

  • マップタイルとコピーライトを取得するための地図サイズと位置
  • ジオコーディングに使用される住所
  • ルート検索(Direction)とエレベーションリクエスト
  • Places検索のための周辺位置(Locations around which to search for Places)
  • KmlLayer (V3) or GGeoXml (V2)を使った時のKML
Google Static Maps APIを使って画像を生成し、それを保存して私のサイトから利用することは出来ますか?

あなたのサイトからGoogle Static Maps APIを使って生成した画像を保存や複製することは認められていません。全てのウェブページは、static map画像は imgタグの src 属性か、HTML divタグのCSS background-image を使って直接Static Maps APIへリンクしなければなりません。つまり地図画像はウェブページのHTMLコンテンツとして表示され、Googleによってエンドユーザに直接提供されます。


Maps APIに適用される使用量制限とは何ですか?

次の範囲において、ウェブサイトとアプリケーションは各Maps APIをコストが発生することなく使用出来ます。

  1. 各APIにおいて、地図の読込回数が 25,000回 / 日
  2.  Styled Maps によって調整された地図のロードは 2,500 回 / 日

もしあなたのアプリケーションがこれらの使用量制限を超えるならば、次の方法のいずれかにて、あなたのアプリケーションでMaps APIの使用を継続する方法を選ばなければなりません。

  • 超過使用料の自動支払いに加入する
  • Maps API Premier ライセンスを購入する

非営利でアプリケーションが公益向け(Googleによる判断に依存します)の場合は、この使用量制限に従いません。例えば、災害救済地図は商業活動をする団体によって開発され、またはホストされているときでも、使用量制限に従いません。さらに私たちは有資格非営利団体の場合は Google Earth Outreach プログラムを通じてGoogle Maps API Premierライセンスに申し込むことをお勧めします。この提供は広告表示義務を避ける権利、Maps API Webサービスの高い割り当て、そしてテクニカルサポートを含み、とても有益です。

地図の読込の正確な定義は こちらです。料金に関する詳細は こちらです。

私のサイトは大量のトラフィックがあります(とても人気なサイトです)。Google Maps APIを使うことは出来ますか?

はい。ですがあなたが usage limits とGoogle Maps API Web Servicesの1日単位の制限を習熟し信用できるように慣れることをお勧めします。

サービスに適切なJavaScriptやActionScriptクラスを使用することで、ウェブサービスの制限に影響されるリスクを大幅に軽減できます。詳しい情報は Geocoding Strategies の記事をご覧ください。

Maps APIに適用される使用量制限の”地図のロード”の構成は何ですか?

地図の1ロードは次のように発生します。

  1. Maps JavaScript API (V2 or V3) がウェブページやアプリケーションに読み込まれるとき。
  2. ウェブページやアプリケーションにより、Maps API for FlashによってSWF向けのMap APIが読み込まれるとき。
  3. Static Maps API に 地図画像のリクエストが1回されたとき。
  4.  Street View Image API に パノラマ画像のリクエストが1回されたとき。

地図が一度が読み込まれたあと、ユーザが地図の操作をする度合いは使用量に影響しません。

もし私のサイト or アプリケーションが突然人気になったら、地図は動かなくなってしまうのでしょうか。

いいえ。あなたの地図は機能を継続します。しかしもしあなたのアプリケーションがMaps API 使用量制限に絶えず値し、Maps API Premier licenseを持っていないのであれば、地図の超過使用料のオンライン支払いに入ることはできず、あなたの地図に警告が表示され、Maps API Premierセールスマネージャーがあなたにライセンスの選択について連絡するでしょう。

地図ロードの超過使用量のオンラインコストはいくらですか?

使用量制限の以下の負荷のボリュームを生成するアプリケーションは、アプリケーションがサービスのGoogle Maps APIの規約 の要件を満たして提供される場合は、無償でMaps APIを使用することができます。地図読込の使用量を超過した時の料金は次の通り。

サービス使用量制限
(1日あたり)
1,000回ごとの超過読込
(in U.S. dollars)
JS Maps API v325,000$4
JS Maps API v3 styled maps2,500$4[1] / $8[2]
Static Maps API25,000$4
Static Maps API styled maps2,500$4[1] / $8[2]
Street View Image API25,000$4
JS Maps API v225,000$10
[1] - 2,500 から 25,000 回の地図の読込 / 日
[2] - 25,000 回を超える地図の読込 / 日

超過した地図読込はMaps API for Flashには提供されません。Maps API for Flashを使ったサイトの使用量超過の場合は、JS Maps API v3へ移植していただくか、Maps API Premier ライセンスをご購入ください。

超過の地図の読込は Google APIs Consoleを通じて販売されます。使用量は日毎に計算され、超過量を月単位でクレジットカードに請求されます。もし絶えず1日に高いボリュームの地図読込が発生するようでしたら Maps API Premier ライセンスのがより費用対効果が高いです。

またオンラインでの超過使用量の支払いは Terms of Service 下でのMaps APIの継続利用以外に何も追加的な権利や利益をもたらしません。

私が送信できるジオコーディングの数のリミットはありますか?

Maps API Geocoding Web Serviceのドキュメントにはサービスに適用される 使用量制限 について記載されています。それらの制限に影響されるリスクを軽減するためのオススメを含む詳細な情報は、Geocoding Strategies の記事をご覧ください。


Google Maps APIキーのシステムはどのように機能しますか?

注: Google Maps APIキーは、JavaScript Maps API V2とMaps API for Flashを使った時のみ必要です。
(Google Maps API V3を使うときには使わないでください)

Google Maps APIキーを取得するためには、必ずGoogle Accountにサインインして Terms of Service に同意してください。1つのアカウントで取得できるキーの数には制限はありません。

ほとんどのアプリケーションでは、単にドメイン名を登録するだけをお勧めします。あなたのキーはそのドメインと、サブドメインでも有効で、それらのドメインでホストする全てのURLとポートで使えます。

例えば, もしあなたが http://www.mygooglemapssite.com/を使ってサインインしたら、あなたのキーは次のURLで有効です。

  • http://www.mygooglemapssite.com/
  • http://www.mygooglemapssite.com/mysite/

しかし次の場合は有効ではありません。

  • http://mygooglemapssite.com/
  • http://host1.mygooglemapssite.com/
  • http://host2.mygooglemapssite.com/mysite

もしお勧めしたように http://mygooglemapssite.com/ でサインインしたら、あなたのキーは上記のURL全てが有効です。

注:http://www.mygooglemapssite.com/ のAPIキーは、サイトがこのアドレスを使ってアクセスされた時のみ有効です。サイトが IP アドレス (eg. http://10.1.2.3/) やDNS CNAMEレコードのエイリアス(例: www.mygooglemapssite.com)を使ってアクセスされたときは有効ではありません。

Javascript Maps API V2 を使っていてAPIキーが有効ではないときは、あなたのコードの中に alert(window.location.host)を置き、ページをリロードしてください。alertにあなたがサインインするべきドメインが表示されます。

 Maps API for Flashを使っていてAPIキーが有効でないときは、SWFを配信元がキーを登録したドメインかどうか、SWFが埋め込まれているドメインが登録されていないか確認してください。

複数のドメインでホストして利用しているとき、どうやって私のアプリケーションは有効なAPIキーを使うように設計したら良いでしょうか。

Note: Google Maps API keys are only required when using the JavaScript Maps API V2 and the Maps API for Flash.

Some applications may be hosted on multiple domains. For example, many content management systems push the same content to different domains (e.g.example.com and example.net) and wish to have that content single-sourced. Since Google Maps API keys are generated per domain, you'll need to generate separate keys for each domain and configure your application to use the correct one. The easiest way to do this in JavaScript is to dynamically generate the <script> tag using document.write and assigning the correct domain-specific key within the src attribute's URL as a parameter. In doing so, you'll need to pre-generate and hardcode the list of keys within your application.

One technique we suggest is to create an object which contains a mapping between domain names and its corresponding Google Maps API keys. Usewindow.location.host to retrieve the domain name your application is running against, and pass it into the object to select the appropriate key.

Below is a JavaScript snippet you can copy and paste into your application. Replace property names labeled domain*.com on the left with your list of domains and assign to each entry its corresponding and unique Google Maps API key.

document.write([
  '<script src="http://maps.google.com/maps?file=api&amp;v=2&amp;key=', {
    'domain1.com': 'apikey1',
    'domain2.com': 'apikey2',
    'domain3.com': 'apikey3',
    'domainN.com': 'apikeyN'
  }[window.location.host],
  '" type="text/javascript"><\/script>'
].join(''));

When using the snippet above, be sure to include it within your HTML document above any <script> tags or JavaScript containing references to Google Maps API objects.

Google Maps APIの各バージョンの変更の概略を知るにはどうすればいいですか?

 JavaScript Maps API V3の各バージョンの変更リストは、以下のURLにあります。

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

Google Maps API Issue Trackerで、特定のバージョンのバグが紹介されていて修正されていないか確認してください。

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

ページが読み込まれたあとに非同期にAPIをロードするにはどうすればいいですか?

APIを読み込むときにcallbackパラメータを指定すればいいです。詳しい情報とサンプルコードは こちらのドキュメント にあります。

Google Maps APIで英語以外を表示することはできますか?
The map controls, tooltips, and copyrights have been translated for a subset of languages, listed in the spreadsheet below. The API will sense the browser settings of the user and set the language appropriately. It is possible to override the language in the APIs; more information is available in the JavaScript API documentation and the Flash API reference.

Check out the Supported Languages Spreadsheet.

SSL(HTTPS)を使ってGoogle Maps APIにアクセスすることは出来ますか?

The Google Maps JavaScript API V3, Google Static Maps API, and Google Maps API Web Services can be accessed over secure (HTTPS) connections by developers using either the free version of these APIs or Google Maps API Premier. Please see the documentation for the API concerned for information on how to access the API over SSL.

The Google Maps JavaScript API V2 and Google Maps API for Flash can be accessed over a secure (HTTPS) connection by Google Maps API Premiercustomers only. If these Maps APIs are used with a free Maps API key on a secure site, the browser may warn the user about non-secure objects on the screen.

SSL(HTTPS)でホストされるサイトでGoogle Maps API for Flashアプリケーションは利用することができますか?

The Google Maps API for Flash can be used in a Flash application (SWF file) that is hosted on an SSL (HTTPS) site. However only Google Maps API Premiercustomers can load the Google Maps API for Flash over HTTPS. When the Google Maps API for Flash is loaded by a Flash application hosted on an https site using a free Maps API Key, the API is loaded over HTTP, and all connections to Google made by the API are over HTTP.

To load the Google Maps API for Flash using a free Maps API key in a Flash application hosted on an SSL site, you must:

  • Use Google Maps API for Flash version 1.9a or later.
  • Add the following to your Flash application before the map is instantiated:

    Security.allowInsecureDomain("maps.googleapis.com");

Flash APIの中でBitmapData.draw/3Dエフェクトを使うとどうしてセキュリティ・サンドボックス・エラーになるのでしょうか。

The Maps API for Flash does not currently allow calls to BitmapData.draw(). Calling this method will result in a run-time Security Sandbox error. Several ActionScript libraries call this function in order to enable transitions or 3-d effects, such as PaperVision3d. If you are using those libraries in your application, make sure you're not using them on the map. To be notified if this situation changes, please star this issue .

Google Maps APIのバグや新機能のリクエストは、どうやって報告することができますか?

If you experience behavior that you believe may be a bug, please begin by raising it in the relevant forum. This will allow other developers to validate the bug, and rule out any potential issues with your code.

If you wish to request a feature, please also first raise it in the relevant forum to confirm that a solution that meets your requirements is not already available.

Once you have confirmed that you have identified a new bug, or that your requirements can not be met by the existing functionality of the Google Maps APIs, please report your bug or feature request using the Google Maps API Issue Tracker.

Before adding a bug or feature request to the Issue Tracker please be sure to check that the bug or feature concerned has not already been added. If it has, you can star the issue to register your interest and be notified of updates.

私はこれらとは違う質問や問題があります。誰に連絡したらよいでしょうか。

Please post your question in the relevant forum to get help from the Google Maps developer community. The Google Maps team also monitors and participates in this group.

For best results when requesting help, please keep the following in mind:

  • Search the current discussions. Chances are someone else has experienced a similar issue and found a fix.
  • Submit a link to your site if possible. Only post code snippets if the code is not easily viewable online.
  • Provide all relevant information including browser versions, errors, and all other facts that may be useful in troubleshooting this problem.

Google Maps API Premier customers may also contact Google Enterprise Support.


住所を緯度経度のペアに変換しなければならないのですが、Google Maps APIを使ってできますか?

Yes, this process is called "geocoding." each of the Google Maps APIs includes a class for performing geocoding. The classes are:

Alternatively Google also provides a Geocoding Web Service, which offers a REST interface that can respond in JSON and XML formats.

Please be aware of the usage limits that apply to geocoder requests, and note that use of the geocoder for any purpose other than obtaining locations that will be displayed using the Google Maps APIs is a violation of the Terms of Service. You may use the HTTP geocoder to geocode addresses outside of your Google Maps API application so that they may be cached and later displayed using one of the Google Maps APIs, but locations obtained using the Geocoding Web Service may not be used by any other application, distributed by other means, or resold.

どの国でジオコーディングは利用可能ですか?

To see countries currently supported by the Google Maps APIs geocoders, please check out this spreadsheet and select "Yes" in the geocoding dropdown.

The accuracy of geocoded locations may vary per country, so you should consider using the returned location_type field to determine if a good enough match has been found for the purposes of your application. Please note that the availability of geocoding data depends on our contacts with data providers, so it is subject to change.

For geocoding in countries not currently supported by the Google Maps APIs, please browse this list of other geocoding services.

どうしてGoogle Maps APIジオコーダーはGoogle Mapsとは違う位置を返すのでしょうか。

APIジオコーダーとGoogle Mapsジオコーダーはときどき違うデータセットを使います(国によって違います)。APIジオコーダーはたまに新しい更新されたデータを取得しますので、結果の変化を見ることやオーバータイムの向上を期待できるかもしれません。

どのようにジオコーディングするために、ハイウェイ上のアメリカの住所を形式化するべきですか?

The Google Maps APIs geocoder requires that U.S. numbered highways be specified in addresses as follows:

  • County Roads: "Co Road NNN" where NNN is the road number. eg. "Co Road 82"
  • State Highways: "State NNN" where State is the full name of the state and NNN is the highway number. eg. "California 82"
  • U.S. Highways: "U.S. NNN" where NNN is the highway number. eg. "U.S. 101"
  • U.S. Interstates: "Interstate NNN" where NNN is the interstate number. eg. "Interstate 280"
ジオコーダーのレスポンスのAccuracy(精度)とはどういう意味でしょう。

The Accuracy value represents the scale of the feature that has been geocoded. It does not represent a ranking or level of confidence in the result.

When the geocoder receives a query it attempts to find the best matched feature for the address given. Depending on the amount of data we have for the area concerned, the geocoder may be able to identify a specific building that matches, or it may only be able to match the street or district.

If the geocoder can only match a higher level feature such as the district it will still return a lat/long, but it will be for the centroid of that feature, which is likely to be offset from the location of the specific address requested. The Accuracy tells you the scale of the object that matched, so you know how precise the geocode is likely to be.

The list of possible values for the Accuracy and the scale of feature that each represents is given in the documentation:

ジオコーダーのクエリを最大限成功するようにするにはどういう形式にするべきでしょうか。

The geocoder is designed to map street addresses to geographical coordinates. We therefore recommend that you format geocoder requests in accordance with the following guidelines to maximise the likelihood of a successful query:

  • Specify addresses in accordance with the format used by the national postal service of the country concerned.
  • Do not specify additional address elements such as business names, unit numbers, floor numbers, or suite numbers that are not included in the address as defined by the postal service of the country concerned.
  • Use the street number of a premise in preference to the building name where possible.
  • Use street number addressing in preference to specifying cross streets where possible.
  • Do not provide 'hints' such as nearby landmarks.
どのようなときAPIジオコーダークラスを使うべきで、どのようなときHTTPジオコーディングサービスを使うべきですか?

こちらの記事「 Geocoding Strategies 」をお読み頂き、ジオコーディングの方法の違いの長所と短所を理解してください。

Google Maps APIを使ってルート案内を提供するにはどうしたらできますか?

The Google Maps Javascript API allows you to provide driving directions via the google.maps.DirectionsService class. This class provides you with step-by-step access to basic and multi-point driving directions. The DirectionsRenderer class can automatically create the overlays and directions panel for you.Additional examples are provided in the documentation.

You can also easily link to Google Maps for driving directions. We suggest you use the following format for driving directions on Google Maps:

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

どの国でルート検索を利用することができますか?

To see countries currently supported by Driving Directions in the Maps API, check out this spreadsheet and choose "Yes" in the driving directions column dropdown. Please note that the availability of driving directions data depends on our contacts with data providers, so it is subject to change.

KML と GeoRSSのどの機能がGoogle Maps Javascript APIでサポートされていますか?

JavaScript APIの KmlLayer クラスはディベロッパーにKML/KMZ と GeoRssを地図上にマップできるようにします。例は こちら

KmlLayer クラスがサポートする現在のKMLのドキュメントはこちら。

http://code.google.com/apis/kml/documentation/mapsSupport.html

Google Maps Javascript APIのKmlLayerクラスを使って、どれだけのサイズと複雑なKMLを表示することができますか?

KmlLayer クラスを使ったKMLの表示における複雑さとサイズの制限は、こちらに記載されています。

http://code.google.com/apis/kml/documentation/mapsSupport.html

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

There is no limit to the number of markers or path vertices supported by the Google Static Maps API. However Static Maps API URLs can be a maximum of approximately 2,000 characters which constrains the number of markers and path vertices that can be specified based on the number of decimal places used when specifying each latitude/longitude pair. For information on how the number of decimal places used relates to the accuracy on the Earth see the Wikipedia article on Decimal Degrees.


私の地図上に広告を含めてもいいですか?

Yes, you're welcome and encouraged to monetize your maps mashup through advertising. The JavaScript Maps API offers an AdSense Library to help you add advertising to your maps mashups. Read the developer's guide for more information.

You can also put AdSense ad units on the same page as your map mashup, outside of the map.

To sign up for AdSense and get a publisher ID, or to learn how to put ad units on your page, visit adsense.google.com.

私のAdSense publisher IDはどうやって見つけることができますか?

To find your unique AdSense publisher ID number, log into your AdSense account at http://www.google.com/adsense. On the My Account tab, scroll down to the Property info section. Your publisher ID for each AdSense product and feature will be located in this section.

Alternatively, you can find your publisher ID number within your AdSense code. Just locate the AdSense code in the HTML source code of your website, and you'll spot your publisher ID in a line like the one shown below:

google_ad_client="ca-pub-xxxxxxxxxxxxxxxx";

AdSenseチャネルとは何でしょうか。

AdSense Help Centerの information on channelsを参照してください.

どの国でadsレイヤーを使った広告は利用できますか?

Any developer whose page content is in one of the AdSense for Content languages can implement the ads layer. Currently, only advertisers from the United States will show ads in the ads layer. As the program continues, ads from advertisers in other countries may become available.

私はadsレイヤーを使っているのですが地図上にadマーカー(広告マーカー)が表示されません。何が間違っていますか?

Note: This FAQ entry applies to V2 (deprecated). V3 uses the AdUnit class to display ads on or around the map.

If you've implemented the ads layer by initializing a GAdsManager on your map and aren't seeing any ads, there may be several reasons:

  • The first thing to do is to check your code: make sure you pass a valid AdSense ID into the GAdsManager constructor, and make sure you callenable() on GAdsManager after initialization.
  • If the page your map is on has never been crawled by Google, you'll need to wait 2-24 hours for it to be crawled. The page needs to be crawled so that AdSense can analyze the text around your map for keywords. Make sure your robots.txt file is designed so that the Googlebot can crawl the directory your map is residing in. More information on Google site crawling is available here.
  • There are several reasons why AdSense may choose not to display ads on your site after seeing the results of the Googlebot crawl. Please refer to theinformation on these restrictions in the AdSense Help Center.
  • If you've followed the above steps, you should see occasional ad markers show up on your map. Where ads show up will depend on locations advertisers are targeting. You're more likely to see ad markers show up around densely populated cities, as there are a greater number of advertisers in those areas. In addition, you likely will only see ads show up when the map is centered on an area within a country where ads layer ads are available.
Comments