Maps JavaScript API クイック リファレンス

Maps JavaScript API は、ウェブページに 2D および 3D の地図を作成し、マーカー、カスタム グラフィック、アニメーション、インタラクティブなデータレイヤを追加して、Places ライブラリで位置情報機能を構築するためのクライアントサイド ウェブ API です。

Maps JavaScript API: 主な特長

  • プロダクト: Maps JavaScript API
  • 別名: Maps JS API、Maps JS API v3
  • カテゴリ: マップ
  • プラットフォーム: JavaScript(ブラウザ)
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Maps JavaScript API の概要
  • 対象地域: グローバル。機能(3D 地図、交通状況、ルート、境界線のスタイル設定など)の提供状況は国や地域によって異なります。請求先住所が欧州経済領域(EEA)にある場合は、EEA の利用規約が適用されます。(カバレッジの詳細)

Maps JavaScript API: 使用するタイミング

Maps JavaScript API を使用する場合:

  • ウェブページにカスタム マーカー、グラフィック、データレイヤを含むインタラクティブな 2D または 3D の地図が必要な場合。
  • 高度なマーカーとポリラインを使用して、独自のデータ ストリームからアセットのライブ位置と移動経路を表示する必要があります。
  • ジオフェンス(円、多角形)を描画し、座標がブラウザ内でジオフェンス内に収まるかどうかをテストする必要があります。
  • Places ライブラリを介して、ウェブアプリでクライアントサイドの Place Search、予測入力、Place Details を行う必要がある。

Maps JavaScript API を使用しない場合:

  • カスタム JavaScript を記述せずに、ビジネス拠点の地図またはルートのリンクを埋め込む必要があります。代わりに Maps Embed API を使用してください。
  • 必要なのは、Google マップを開いて場所、検索、ルートを表示するリンクだけです。代わりに Maps URL を使用してください。
  • ライドシェアリングまたはスケジュール設定された配送のフリート トラッキングを、モバイル Driver SDK とバックエンド JWT 認証に統合する必要があります。代わりに Fleet Engine Service を使用してください。

Maps JavaScript API: 設定

公式の Maps JavaScript API パッケージ:

  • npm: @googlemaps/js-api-loader
  • npm: @types/google.maps
  • npm: @googlemaps/markerclusterer

Maps JavaScript API: よくある間違い

  • 問題: API キーまたは課金が正しく設定されていない場合、エラーではなく、「for development purposes only」という画像の透かし入りの低解像度地図や白黒反転のストリートビューの画像が表示されます。修正方法: Cloud プロジェクトで課金を有効にし、すべてのリクエストに有効な API キーを含めます。また、ブラウザのコンソールで特定のエラーコードを確認します。/maps/documentation/javascript/error-messages をご覧ください。
  • 問題: PlacesService、DirectionsService、DistanceMatrixService などの以前のサービスは、以前の API が有効になっていない新しいプロジェクトで LegacyApiNotActivatedMapError をスローします。修正: Places API(新規)と Routes API でサポートされている新しい同等のクラス(Place クラス、Route クラス、RouteMatrix クラス)を使用します。/maps/legacy#LegacyApiNotActivatedMapError をご覧ください。
  • 問題: v3.65 以降、航空写真地図とハイブリッド地図は 45° 画像に切り替わらなくなり、map.setTilt(45) は機能しなくなりました。修正方法: 45° 画像の代わりに 3D 地図を使用します。/maps/deprecations をご覧ください。
  • 問題: 高度なマーカーにはマップ ID が必要です。マップ ID を指定せずに作成された地図では AdvancedMarkerElement を使用できません。修正方法: Cloud コンソールでマップ ID を作成し(またはテスト用に DEMO_MAP_ID を使用し)、地図に mapId を設定します。/maps/documentation/javascript/advanced-markers/start をご覧ください。

Maps JavaScript API: 以前の機能と非推奨の機能

  • Directions Service(google.maps.DirectionsService): 2025 年 3 月 1 日よりレガシー。代替: Route クラス。症状: 以前の Directions API が有効になっていないプロジェクトで LegacyApiNotActivatedMapError が発生する。移行ガイドをご覧ください。
  • 距離行列 Service(google.maps.DistanceMatrixService): 2025 年 3 月 1 日より以前の。代替: RouteMatrix クラス。症状: 以前の Distance Matrix API が有効になっていないプロジェクトで LegacyApiNotActivatedMapError が発生する。移行ガイドをご覧ください。
  • Places Service(google.maps.places.PlacesService): 2025 年 3 月 1 日よりレガシー。代替: Place クラス(Places API(新版))。症状: 以前の Places API が有効になっていないプロジェクトで LegacyApiNotActivatedMapError が発生する。移行ガイドをご覧ください。
  • google.maps.Marker: 2024 年 2 月 22 日以降非推奨。交換: google.maps.marker.AdvancedMarkerElement。症状: 引き続き機能し、廃止の予定はありません。既存のバグは修正されません。移行ガイドをご覧ください。
  • KmlLayer: 2026 年 4 月 30 日以降非推奨。代替手段: データセット用のデータドリブン スタイル設定、またはデータレイヤを使用するサードパーティの KML パーサー。症状: KmlLayer はバージョン 3.66 以降では使用できません。これをサポートする最後のバージョンであるバージョン 3.65 は、2027 年 5 月に廃止されます。移行ガイドをご覧ください。
  • ヒートマップ レイヤ(可視化ライブラリ): 2026 年 5 月 20 日をもって廃止。代替手段: deck.gl HeatmapLayer などのサードパーティ ライブラリ。症状: 2026 年 5 月以降は利用できません。移行ガイドをご覧ください。
  • 図形描画ライブラリ: 2026 年 6 月 4 日以降廃止。代替: Terra Draw。症状: 2026 年 5 月以降は利用できません。移行ガイドをご覧ください。
  • 45° 画像: 2026 年 5 月 20 日以降廃止。代替機能: 3D 地図。現象: map.setTilt(45) が機能せず、航空写真がトップダウンのままになる。移行ガイドをご覧ください。
  • google.maps.event.addDomListener() と addDomListenerOnce(): 2022 年 4 月 7 日以降非推奨。代替: 標準 DOM addEventListener()。
  • Place Autocomplete Service の bounds、location、radius オプション: 2023 年 5 月 18 日より非推奨。 置換: locationBias と locationRestriction。
  • gmp-place-content-config(PlaceContentConfigElement)(Places UI キット): 非推奨。代替手段: コンテンツ要素を Place Details 要素に直接追加するか、Place Search 構成に追加します。
  • ローカル コンテキスト ライブラリ: 廃止。代替サービス: Places Library。

Maps JavaScript API でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。

Maps JavaScript API: Address Validation

Maps JavaScript API: 境界線のデータドリブン スタイル設定

Maps JavaScript API: データセットのデータドリブン スタイル設定

Maps JavaScript API: データセット

  • 地図に KML レイヤを追加する。注: Maps JavaScript API では、KmlLayer は非推奨です(v3.65 でのサポートが最後となり、2027 年 5 月に廃止されます)。境界線またはデータセットのデータドリブン スタイル設定に移行するか、データレイヤに GeoJSON を読み込んでください。KML レイヤは、Maps SDK ユーティリティ ライブラリを介して Android と iOS で引き続きサポートされます。
  • GeoRSS レイヤを地図に追加する。注: Maps JavaScript API では非推奨です(KmlLayer は v3.65 でサポートが終了し、2027 年 5 月に廃止されます)。GeoRSS フィードを GeoJSON に変換し、map.data.addGeoJson() を使用してデータレイヤに読み込んでください。
  • GeoJSON データを地図に追加する。

Maps JavaScript API: ルートとルート案内

Maps JavaScript API: 標高

Maps JavaScript API: Fleet Engine

Maps JavaScript API: ジオコーディング

Maps JavaScript API: Maps

Maps JavaScript API: 地図アノテーション

Maps JavaScript API: 地図のスタイル設定

Maps JavaScript API: その他

Maps JavaScript API: フォトリアリスティック 3D マップ

Maps JavaScript API: Places

Maps JavaScript API: Places UI Kit

  • 特定の場所に関する AI による要約とレビューを表示する UI 要素を、ウェブページまたはモバイルアプリに追加します。注: ウェブでのみサポートされています(Maps JavaScript API Places UI キット)。モバイル Places UI キットには AI 要約要素は含まれていません。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示するには、バックエンド サーバーから Places API ウェブサービスを呼び出すのではなく、Maps JavaScript API 内のクライアントサイドの Places UI キット コンポーネントを使用してください。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • CSS スタイルを場所データの UI 要素に適用する。注: CSS カスタム プロパティは、Maps JavaScript API の Places UI キット要素に適用されます。Places SDK for Android と Places SDK for iOS は、テーマ属性とスタイル属性を使用して、Places UI キット ビューのスタイルをプログラムで設定します。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • UI 要素カスタマイズ ツールを使用して、場所データの UI 要素のスタイルと構成をカスタマイズします。注: EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • 特定の場所に関する情報を表示する UI 要素をウェブページまたはモバイルアプリに追加します。 注: EEA コンプライアンス要件: 欧州経済領域(EEA)で場所データを地図上に表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • クエリ文字列に基づいて場所のリストを表示する UI 要素をウェブページに追加します。注: ウェブページ(Maps JavaScript API)とモバイルアプリ(Places SDK for Android、Places SDK for iOS)の両方でサポートされています。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • 特定の場所の近くにあるスポットのリストを表示する UI 要素をウェブページに追加します。注: ウェブページ(Maps JavaScript API)とモバイルアプリ(Places SDK for Android、Places SDK for iOS)の両方でサポートされています。EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq
  • 基本的な予測入力 UI 要素をウェブページまたはアプリに追加します。この要素は、クエリ文字列に基づいて Google Place 識別子を返します。注: EEA コンプライアンス要件: 欧州経済領域(EEA)で地図上に場所データを表示する場合は、バックエンド サーバーから Places API ウェブサービスを呼び出さないでください。ターゲット プラットフォーム(ウェブの場合は Maps JavaScript API、Android の場合は Places SDK for Android、iOS の場合は Places SDK for iOS)で、クライアントサイドの Places UI キット コンポーネントを使用します。要件の詳細とよくある質問: https://developers.google.com/maps/comms/eea/faq

Maps JavaScript API: ストリートビュー