場所とスポット

商品フィードでは、さまざまな方法で商品に関連付けられたスポットを指定できます。Google はこの情報を使用して、関連するスポットや目的地が検索されたときに、ユーザーに商品を表示します。

各商品の option では、related_location フィールド（RelatedLocation オブジェクトのリストを含む）を使用して、オプションに関連する 1 つ以上のスポット（POI）を指定できます。各 RelatedLocation オブジェクトには、対象のスポットを記述した location と、そのスポットと商品 option の関係を記述する relation_type が含まれています。

商品のオプションは、実際にその場所を訪れるだけでなく、その場所で有意義な体験ができる場合にのみ、関連するものとしてマークしてください。「有意義」の定義は場所によって異なる場合がありますが、通常、関連するものとしてマークすべきでないものには、たとえばボートクルーズやバスツアー中のスポットの眺めや、ツアーの集合場所などがあります（代わりに meeting_point フィールドを使用してください）。3 つの relation_types は次のとおりです。

  • RELATED_NO_ADMISSION: 場所は関連していますが、商品オプションに入場料が含まれていないか、入場料が無関係です。たとえば、場所がシティツアーでハイライト表示された正方形の場合などです。

  • ADMISSION_TICKET: 関係はこの関連する場所への入場許可を付与します。

  • SUPPLEMENTARY_ADDON: リレーションで、関連するロケーションにユーザーを誘導しない追加サービスを宣言しています。たとえば、駐車チケット、企画展などです。

例

relation_type 例
RELATED_NO_ADMISSION 入場せずにエッフェル塔を巡るウォーキング ツアー。ブルジュ ハリファを巡るヘリコプター ツアー。
ADMISSION_TICKET 動物園の入場チケット。追加のアドオンを含めることができます。
SUPPLEMENTARY_ADDON 入場なしの音声ガイドは行列をスキップ。
関連性がない 遠くからスポットが見えるボートクルーズ。ツアーの開始やチケットを購入できるツアー事務所。

各商品 option には、開始位置が不明確で決定する必要がある特定のツアータイプ（ガイド付きツアーなど）用の meeting_point を指定することもできます。

新しいアトラクションの追加をリクエストする方法

観光スポットの公式チケットを提供していて、利用している観光スポットの中に Google のおすすめスポットが含まれていない場合は、TTD New POI リクエスト フォームに記入して、そのスポットをおすすめスポットに追加するようリクエストできます。

受信したフィードを処理する際、Google はテキスト文字列として指定された場所のヒントを、その場所を表す Google 内部エンティティ（スポット（POI））と照合しようとします。

スポットは、特定の場所（座標）上の名前付きピンとして大まかに定義できます。おすすめスポットのコンテキストでは、ツアー オペレーターや観光名所などが適切な例です。ただし、一般的にスポットとは、Google が認識している名前と場所を持つ施設を指します。

位置照合とは、関連するスポットを、Google が認識しているスポット（Google データベースに存在する場合）とテキストのヒントの形式で照合するプロセスです。

関連するビジネス情報を Google に送信する方法は複数あり、位置情報のソース、サプライヤーとの契約要件、照合プロセスに対する制御の程度に応じて異なります。

次のヒントの種類がサポートされています（優先度の高い順）。

ヒントの種類

タイプ 説明 推奨される使用方法
ビジネス プロフィール ID Google でビジネスを一意に識別します。

プロフィールの詳細設定で説明されているとおり、ビジネス オーナーはビジネス プロフィールの詳細設定ページを使用してのみ、ビジネス オーナーから直接取得できます。

Google でビジネスを表すスポットにマッピングされます。マッピングが成功するのは、ビジネスの拠点が Google によって確認されている場合のみです。

この形式では、スポットだけでなく、Google でのサービス提供地域の使用方法で定義されているサービス提供地域およびハイブリッド ビジネスタイプもサポートされています。
  • パートナーはビジネス オーナーと直接的なビジネス関係を結んでいます。
  • 非店舗型ビジネスまたはハイブリッド型ビジネスの場合は、このようなビジネス情報の送信におすすめの方法です。
場所情報 スポットの構造化表現。場所の名前、住所コンポーネント、その他のヒント（電話番号、ウェブサイト、座標など）の個別のフィールドを提供します。

スポットのオーナーからビジネス プロフィール ID を取得できない場合は、この方法をおすすめします。
  • 場所は、サプライヤーまたはデータ所有者から、たとえばサプライヤー向けツールなどを使用して、住所形式で取得されます。
  • 正確な住所は指定されていませんが、砂漠や名前のない道路など、人里離れたエリアにある観光スポットやツアー業者など、名前と座標で識別できます。
  • 可能であれば、Places API を使用して住所とプレイス ID を照合するよりも、この形式を優先してください。これにより、Google は電話番号やウェブサイトなどの追加情報を使用して照合の精度を高めることができます。
プレイス ID Google でスポットを一意に識別します。

場所は、Places API エンドポイント（Place Search や Place Autocomplete など）から取得できます。また、Things to Do Center の [場所の一致検索] ツールを使用して手動で取得することもできます。
  • ビジネス情報は、サプライヤー向け UI ツールによってサプライヤーまたはデータ所有者から提供されています。たとえば、Place Autocomplete を使用して、データ所有者が候補リストから適切なものを選択できるようにします。
  • 照合処理を細かく制御したい場合や、未加工の住所情報を共有したくない場合。
  • スポットのオーナーからビジネス プロフィール ID を取得することが不可能で、場所に関する未加工の情報を Google に送信するのではなく、Places API を使用してお客様側のスポットと住所を照合する場合は、この方法をおすすめします。
緯度と経度 都市、地域区分、旅行先など、地理的または地政学的な地域を大まかに識別します。
  • 特定のスポットではないおおよその位置情報を送信する場合は、この形式を使用します。たとえば、商品を都市や地域に関連付けて、おすすめスポット広告でトリガーできるようにする場合です。
  • この形式は、スポットの表現には適していません。座標を使用してスポットの場所を送信するには、場所情報形式を使用します。
住所 スポット名を非構造化 1 行の住所として表します。必要に応じて場所の名前を含めます。

非推奨。
この形式は 2024 年 5 月 1 日をもってサポートされなくなります。
  • この形式を使用する場合は、新しい Place Info 形式に移行する必要があります。この形式には場所の名前の必須フィールドが含まれており、構造化された住所形式と非構造化形式の住所の両方がサポートされます。
  • または、影響を受けるビジネス情報のヒントをビジネス プロフィール ID またはプレイス ID に移行することもできます。

例

// Example 1: Business Profile ID, copied from the Advanced settings page
// of the Google Business Profile that manages the POI.
"location": {
  "business_profile_id": 11458995034835395294
}

// Example 2: Place Info with structured address, coordinates, website URL,
// and phone number.
"location": {
  "place_info": {
    "name": "Colosseum",
    "phone_number": "+39 063 99 67 700",
    "website_url": "https://colosseo.it/",
    "coordinates": {
      "latitude": 41.8902102,
      "longitude": 12.4922309
    },
    "structured_address" {
      "street_address": "Piazza del Colosseo, 1",
      "locality": "Roma",
      "administrative_area": "RM",
      "postal_code": "00184",
      "country_code": "IT"
    }
  }
}

// Example 3: Place Info with unstructured address.
"location": {
  "place_info": {
    "name": "Eiffel Tower",
    "unstructured_address": "5 Av. Anatole France, 75007 Paris, France"
  }
}

// Example 4: Place Info using place name and coordinates only. This
// configuration is useful for matching POIs located in remote areas without
// an exact street address, such as POIs located in deserts or on unnamed
// roads.
"location": {
  "place_info": {
   "name": "Mutitjulu Waterhole",
   "coordinates": {
     "latitude": -25.3511774,
     "longitude": 131.0326859
    }
  }
}

// Example 5: Latitude and longitude.
// This format maintains the old behavior and will only match to the city or
// region.
// For more accurate matching using coordinates, use PlaceInfo instead,
// which includes a mandatory field for the place name.
"location": {
  "lat_lng": {
    "latitude": 51.5072178,
    "longitude": -0.1275862
  }
}

address フィールドを新しい place_info フィールドに移行する方法

既存の非構造化 address フィールドを新しい place_info フィールドに移行するには、次の操作を行います。

  1. 所有している住所データが構造化されていない場合:
    1. [place_info/name] フィールドにビジネス名を追加します
    2. ビジネス名を含まない住所を place_info/unstructured_address に配置します。
    3. 既存の address フィールドをフィードから削除する
    4. 手順 3 に進みます
  2. 住所データが構造化されている場合は、次の処理を行います。
    1. [place_info/name] フィールドにビジネス名を追加します
    2. street_address、postal_address などの住所情報を place_info/structured_address に追加します。
    3. 既存の address フィールドをフィードから削除する
    4. 手順 3 に進みます
  3. マッチングの精度を向上させるため、website_url や phone_number などのデータを追加します。