マップ URL を使用すると、クロス プラットフォームで使用できる共通の URL を作成して、Google マップを起動したり、検索を行ったり、ルートやナビゲーションを取得したり、地図ビューを表示したり、場所の候補リストを作成したり、ストリートビュー パノラマを表示したりできます。URL の構文はすべてのプラットフォームで同じであり、API キーは必要ありません。
マップ URL: 重要なポイント
- プロダクト: Maps URL
- 別名: Google マップの URL
- カテゴリ: マップ
- プラットフォーム: URL スキーム
- リリース ステージ: GA
- ライフサイクル: アクティブ
- 概要: Maps URL の概要
Maps URL: 使用する場面
Maps URL は次の場合に使用します。
- Android アプリ、iOS アプリ、またはウェブサイトから Google マップを開いて場所を検索したり、検索結果を表示したりするためのリンクが必要です。
- 2 地点間の経路(必要に応じて経由地、移動手段、ターンバイターン方式のナビも指定)を表示した Google マップを開く必要があります。
- API キーを使用せずに、Google マップを地図ビュー、場所の候補リスト、またはストリートビュー パノラマで開く必要がある。
- Android、iOS、パソコンのブラウザで同じように動作する URL 構文が 1 つ必要です。
次の場合には、Maps URL を使用しないでください。
- すでに Place Details をリクエストしており、場所の事前フォーマットされた Google マップのリンク(
googleMapsUriフィールドまたはgoogleMapsLinksフィールド)が必要な場合。代わりに Places API(新版)を使用してください。 - Google マップ アプリを起動する際にモバイル専用の機能が必要な場合。Android 向け Google マップ インテントまたは iOS 向け Google マップ URL スキームを使用します。
Maps URL: 設定
- 使用状況の帰属: オプションの
utm_source(アプリケーション名)とutm_campaign(ユーザーが意図したアクション、例:place_details_search)のクエリ パラメータを Maps URL に追加します。 - 使ってみる: マップの URL を設定する
マップ URL: 関連商品
- よく併用される API: Places API(新版)
マップ URL: よくある間違い
- 問題:
queryに緯度と経度のみを指定した検索 URL では、ピンは表示されますが、地図やサイドパネルに Place Details が表示されません。修正方法:query=PLACE_NAME,ADDRESSを使用するか、queryとともにquery_place_idを追加して、特定の場所の詳細を表示します。/maps/documentation/urls/get-started をご覧ください。 - 問題: プレイス ID パラメータ(
query_place_id、origin_place_id、destination_place_id、waypoint_place_ids)が単独では機能しない。修正方法: プレイス ID パラメータを渡す場合は、必ず一致する基本パラメータ(query、origin、destination、waypoints)を含めます。/maps/documentation/urls/get-started をご覧ください。 - 問題:
waypointsパラメータは、ウェイポイントをサポートしていない Google マップ サービスでは無視され、プラットフォームに依存するカウント制限があります。また、dir_action=navigateは、ナビゲーションが利用できない場合は無視されます。修正方法: モバイル ブラウザで開くリンクには 3 つ以下のウェイポイントを使用し(それ以外の場合は 9 つ)、waypointsまたはdir_action=navigateがすべての Google マップ サービスまたはルートで機能することを前提としないでください。/maps/documentation/urls/get-started#directions-action をご覧ください。 - 問題: マップとストリートビューは同じ
@エンドポイントを共有しているため、適切なアクションが指定されていないマップ URL では、マップが表示されないことがあります。 修正: 地図ビューにはmap_action=map、ストリートビュー パノラマにはmap_action=panoを設定します。/maps/documentation/urls/get-started をご覧ください。 - 問題: Maps URL に
api=1がない場合、すべてのパラメータが無視され、Google マップのデフォルト ビューが開きます。 修正方法: すべての Maps URL にapi=1を含めます(有効な値は1のみです)。/maps/documentation/urls/get-started#forming-the-url をご覧ください。