場所とスポット

商品フィードでは、商品に関連付けられたスポットをさまざまな方法で指定できます。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 も設定できます。

新しい観光スポットの追加をリクエストする方法

観光スポットの公式チケットを提供していて、対象の観光スポットの 1 つが Google の Things To Do Center にない場合、TTD New POI Request Form（TTD 新規スポットリクエスト フォーム）に記入して、そのスポットをおすすめスポットの一部として追加するようリクエストできます。

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

スポットは、特定の場所（座標）に名前付きのピンを配置したものとざっくり定義できます。おすすめスポットの文脈では、ツアー オペレーターや観光スポットなどが該当しますが、一般にスポットとは、Google に登録されている名前と場所を持つ施設のことです。

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

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

サポートされているヒントのタイプは次のとおりです（優先度順）。

ヒントの種類

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

ビジネス プロフィールの詳細設定ページを使用して、ビジネス オーナーから直接取得できます（ プロフィールの詳細設定を参照）。

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

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

スポットのオーナーからビジネス プロフィール ID を取得できない場合は、この方法をおすすめします。
  • 位置情報は、サプライヤー向けツールなどを使用して、サプライヤーまたはデータ所有者から住所形式で取得されます。
  • 正確な住所はないが、名前と座標で特定できる場所（砂漠や名前のない道路などの遠隔地にある観光スポットや旅行会社など）。
  • 可能であれば、Places API を使用して住所をプレイス ID と照合するのではなく、この形式を使用することをおすすめします。これにより、Google は電話番号やウェブサイトなどの追加情報を使用して照合の精度を高めることができます。
プレイス ID Google 上のスポットを一意に識別します。

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

非推奨。
この形式は 2024 年 5 月 1 日をもってサポートを終了します。
  • この形式の使用はすべて、新しい場所情報の形式に移行する必要があります。この形式には、場所名の必須フィールドが含まれており、住所の構造化形式と非構造化形式の両方をサポートしています。
  • あるいは、影響を受けるビジネス情報のヒントを、ビジネス プロフィール 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. place_info/structured_address に住所情報（street_address、postal_address など）を追加します。
    3. フィードから既存の address フィールドを削除する
    4. 手順 3 に進む
  3. website_url や phone_number などの追加データを追加して、照合の精度を高める