Maps URL のクイック リファレンス

マップ 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: よくある間違い

  • 問題: 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 をご覧ください。