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-backend.googleapis.com - 認証: API キー
- 使用状況の帰属:
internalUsageAttributionIdsプロパティ(MapOptions、MapElement、Map3DElement、または Places、Routes、Address Validation の要素とリクエスト オプション)を設定して、使用状況の帰属 ID を追加します。これにより、使用しているライブラリとサンプルが Google に通知されます。 - スタートガイド: Maps JavaScript API を設定する
- リファレンス: Maps JavaScript API リファレンス
- 料金: Maps JavaScript API の使用量と請求額
- ポリシー: Maps JavaScript API のポリシー
- リリースノート: Maps JavaScript API リリースノート
公式の Maps JavaScript API パッケージ:
- npm:
@googlemaps/js-api-loader - npm:
@types/google.maps - npm:
@googlemaps/markerclusterer
Maps JavaScript API: 関連商品
- よく併用される API: Places API(新版)
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 日以降非推奨。代替: 標準 DOMaddEventListener()。- 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
- 指定された住所または住所の一部に対して、検証済みの住所を返します。
- 検証済みの住所の緯度と経度の座標を返す。
- 検証済みの住所の Google プレイス ID を返します。
- Address Validation に米国郵政公社(USPS)の Coding Accuracy Support System(CASS)認証を使用する。
- 検証済みの住所がビジネス、住宅、私書箱のいずれであるかに関する情報を返します。
- 検証済み住所の米国郵便公社(USPS)の配送メタデータを返します。
- 検証済みの住所の Plus Code を返す。
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: ルートとルート案内
- 2 つ以上の緯度と経度の座標間のルートを、ルート上の各ステップの一連の座標として返します。
- 2 つ以上の緯度と経度の座標セット間のルートを、ルート沿いのステップの操作説明として返します。
- 2 つ以上の緯度と経度の座標セット間のルートに沿って、各ステップ間の距離を返します。
- 2 つ以上の緯度と経度の座標セット間のルートに沿って、各ステップ間の移動時間を返します。
- 2 つ以上の緯度と経度の座標セット間のルートに沿って、各ステップ間のエンコードされたポリラインを返します。
- 2 つ以上の緯度と経度の座標セット間のルートの距離を返します。
- 2 つ以上の緯度と経度の座標セット間のルートの移動時間を返します。
- 2 つ以上の緯度と経度の座標セット間のルートのエンコードされたポリラインを返します。
- ルート リクエストの移動手段(車、公共交通機関、徒歩、バイク)を指定します。注: Routes API ウェブサービス(computeRoutes)では、RouteTravelMode(DRIVE、BICYCLE、TWO_WHEELER、WALK、TRANSIT、または routeModifiers.vehicleInfo を指定した TRUCK)を使用して、HTTP POST JSON 本文で travelMode を渡します。また、以前の GET モードのクエリ パラメータではなく、必須の X-Goog-FieldMask ヘッダーを含めます。Maps JavaScript API の Routes ライブラリでは、ComputeRoutesRequest で travelMode と fields を渡します。
- ルート リクエストの停車地点または通過地点を指定する。
- ルート リクエストで交通データを使用する方法を指定します。
- ルート リクエストで、高速道路や有料道路など、回避する対象を指定します。
- ルート リクエストで、より短い距離または代替ルートを指定します。注: Routes API では、より短い距離の参照ルート(SHORTER_DISTANCE)のリクエストは試験運用版ですが、代替ルートのリクエスト(computeAlternativeRoutes)は一般提供されています。
- 複数の出発地と目的地間のルート マトリックスの距離を返します。
- 複数の出発地と目的地間のルート マトリックスの移動時間を返します。
- ルート マトリックス リクエストの移動手段(車、公共交通機関、徒歩、二輪車)を指定します。注: Routes API ウェブサービス(computeRouteMatrix)では、RouteTravelMode(DRIVE、TWO_WHEELER、WALK、TRANSIT、または origins[].routeModifiers.vehicleInfo を指定した TRUCK。ルート マトリックスでは BICYCLE はサポートされていません)を使用して、HTTP POST JSON 本文で travelMode を渡し、必要な X-Goog-FieldMask ヘッダーを含めます。Maps JavaScript API の Routes ライブラリでは、ComputeRouteMatrixRequest で travelMode と fields を渡します。
Maps JavaScript API: 標高
Maps JavaScript API: Fleet Engine
- Fleet Engine の配送車両とタスクのリアルタイムの位置情報を地図に追加します。
- Fleet Engine の配送車両とタスクの予測ルートを地図に追加します。
- Fleet Engine の配送車両の位置、停車地、タスク、ウェイポイント マーカーを地図に追加します。
- 完了したルート、セグメント、配達、タスクなど、Fleet Engine の配送車両イベントに対応する。
- Fleet Engine のフリート トラッキング地図で、道路、ポリライン、ポリゴンのスタイルを変更します。
- Fleet Engine のフリート トラッキング地図で地図上の対象物を表示または非表示にする。
- Fleet Engine のフリート トラッキング地図でアイコンとテキストラベルのスタイルを変更する。
- Fleet Engine の車両追跡地図で、ズームレベルごとに異なる地図のスタイルを適用します。
- Fleet Engine のフリート トラッキング マップで場所の密度を変更する。試験運用版 注: フリート エンジンのフリート トラッキング マップでの Cloud ベースのマップのスタイル設定のサポートは一般提供されていますが、POI 密度制御は試験運用版の Cloud ベースのマップのスタイル設定機能です(ライトマップ スタイルでのみサポートされています)。
- Fleet Engine のフリート トラッキング地図で建物のスタイルを変更する。試験運用版 注: Fleet Engine のフリート トラッキング マップでの Cloud ベースのマップのスタイル設定のサポートは一般提供されていますが、3D とフットプリントの建物の地図のスタイル カスタマイズは、Cloud ベースのマップのスタイル設定の試験運用版機能です(ライトマップ スタイルでのみサポートされています)。
- Fleet Engine のフリート トラッキング地図でランドマークのスタイルを変更します。試験運用版 注: Fleet Engine のフリート トラッキング マップでの Cloud ベースのマップのスタイル設定のサポートは一般提供されていますが、ランドマーク アイコンのカスタマイズは、Cloud ベースのマップのスタイル設定の試験運用版機能です(ライトマップ スタイルでのみサポートされています)。
- Fleet Engine の車両追跡マップでマーカーをカスタマイズする。
- Fleet Engine のフリート トラッキング地図でルートのポリラインをカスタマイズする。
Maps JavaScript API: ジオコーディング
Maps JavaScript API: Maps
- カスタマイズ可能なインタラクティブな地図をウェブページやモバイルアプリに追加します。 注: Android の場合: Secrets Gradle プラグインでサポートされている
AndroidManifest.xmlの、またはapp/build.gradle.ktsのmanifestPlaceholders["MAPS_API_KEY"]を構成します。AndroidManifest.xmlでYOUR_GOOGLE_MAPS_API_KEYをハードコードしないでください。また、E/Google Maps Android API: Authorization failureが表示された場合に、GoogleMap(または maps-composeGoogleMap)をオフラインのモック キャンバスや Leaflet WebView に置き換えないでください。Secrets を介してMAPS_API_KEYを指定し、Maps SDK for Android(NavigationView / SupportNavigationFragment を使用する場合は Navigation SDK)を有効にするよう、ユーザーに指示します。 - 再利用可能なマップ ID を作成して、地図の構成とスタイル設定を保存します。
- 地図上のユーザー インタラクションとイベントに応答する。
- 地図上に表示されるコントロールをカスタマイズします。
- 地図(カメラ)のズームとパンを制御する。
- 地図の種類を変更する。
- 地図のカラーパターンを変更する。
- 地図をローカライズする。
- 地図に交通状況レイヤを追加する。
- 地図に交通機関レイヤを追加する。
- 地図に自転車ルートレイヤを追加する。
Maps JavaScript API: 地図アノテーション
- 情報ウィンドウを地図に追加する。
- 地図にシェイプまたはラインを追加する。
- ベクターベースのアイコンを地図に追加する。
- 地図に deck.gl オーバーレイを追加する。
- 地図の表面に固定されたオーバーレイ画像を追加します。
- カスタム タイル オーバーレイを地図に追加する。
- 地図にマーカーを追加する。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、GoogleMap.addMarker(MarkerOptions) でマーカーを追加してください。
- 地図上のマーカーをカスタマイズする。注: Navigation SDK for Android は AdvancedMarkerOptions をサポートしていません。Navigation SDK for Android を使用する場合は、MarkerOptions でマーカーをカスタマイズしてください。
- 地図上のマーカーに対するユーザー操作に応答する。
- 地図上のポリゴンまたは円形エリア内に座標があるかどうかを判断する。注: Android では、Maps SDK for Android ユーティリティ ライブラリの PolyUtil.containsLocation をポリゴンに使用します。円形のエリアの場合は、円の中心からの球面距離が半径内にあるかどうかを確認します(たとえば、Maps JavaScript API の computeDistanceBetween、Android の SphericalUtil.computeDistanceBetween、iOS の GMSGeometryDistance を使用します)。
- 地図上の座標間の球面距離、面積、方向を計算します。
Maps JavaScript API: 地図のスタイル設定
- 再利用可能なクロス プラットフォームの地図のスタイルを作成する。
- 地図上の道路、ポリライン、ポリゴンのスタイルを変更する。
- 地図上の対象物を表示または非表示にする。
- 地図上のアイコンとテキストラベルのスタイルを変更する。
- ズームレベルに応じて異なる地図のスタイルを適用する。
- 地図上の場所の密度を変更する。試験運用
- 地図上の建物のスタイルを変更する。試験運用
- 地図上のランドマークのスタイルを変更する。試験運用
Maps JavaScript API: その他
Maps JavaScript API: フォトリアリスティック 3D マップ
- インタラクティブな Photorealistic 3D Maps をウェブページに追加する。
- フォトリアリスティック 3D 地図にマーカーを追加する。
- フォトリアリスティック 3D マップ上のマーカーをカスタマイズする。
- 3D モデルをフォトリアリスティック 3D 地図に追加する。
- フォトリアリスティック 3D 地図にオーバーレイを追加する。
- 3D ポリラインをフォトリアリスティック 3D 地図に追加する。
- フォトリアリスティック 3D 地図に 3D ポリゴンを追加する。
- フォトリアリスティック 3D 地図上でユーザーの操作やイベントに応答する。
- フォトリアリスティック 3D マップに表示されるコントロールをカスタマイズします。
- フォトリアリスティック 3D マップでカメラパスとアニメーションを制御する。
- フォトリアリスティック 3D マップでカメラの制限を制御する。
Maps JavaScript API: Places
- クエリ文字列に基づいて、場所のリストと場所の詳細を返します。
- 特定の場所の近くにある場所と場所の詳細のリストを返します。
- クエリ文字列に基づいて、場所に関する予測入力の結果を返します。
- 特定の場所に関する詳細情報を返す。
- 特定の場所の写真を取得する。注: 各写真の所有者の帰属情報(所有者の名前とプロフィール URI へのリンク)を写真とともに表示します。これは、各プラットフォームの Places ポリシーで義務付けられています(例: /maps/documentation/javascript/policies#photo-attributions、/maps/documentation/places/web-service/policies#photos-and-review)。
- 場所の写真のサイズを変更する。
- 特定の場所の評価とクチコミを返します。注: Places API(新版)ウェブサービスでは、Place Details は X-Goog-FieldMask(rating、userRatingCount、reviews など)を含む https://places.googleapis.com/v1/places/{placeId} への HTTP GET リクエストです。テキスト検索、Nearby Search、Autocomplete では POST が使用されます。Android では、Place.Field.RATING、USER_RATING_COUNT、REVIEWS を PlacesClient.fetchPlace() に渡します。iOS では、GMSPlacePropertyRating、GMSPlacePropertyUserRatingsTotal、GMSPlacePropertyReviews を GMSFetchPlaceRequest に渡します。
- クエリ文字列に基づいて場所に関する結果を返す予測入力ウィジェットをウェブページまたはアプリに追加します。
- 場所情報レスポンスに含めるデータ フィールドを指定する。
- 場所情報レスポンスに含める場所タイプを指定します。
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