地理位置和地图注点

商品 Feed 提供多种方式来指定与商品相关的兴趣点。Google 会使用此信息在用户搜索相关 POI 或目的地时帮助向其展示相应商品。

每个商品 option 都可以使用 related_location 字段（包含 RelatedLocation 对象列表）指定与相应选项相关的一个或多个兴趣点 (POI)。每个 RelatedLocation 对象都包含一个 location（用于描述相关 POI）和一个 relation_type（用于描述 POI 与产品 option 之间的关系）。

仅当商品选项除了提供实地参观体验之外还提供其他有意义的地理位置体验时，才应标记为“相关”。“有意义的”的定义可能因地点而异，但通常不应标记为“相关”的事项包括：乘坐游船或观光巴士等交通工具时看到地图注点，或者游览的会面地点（改用 meeting_point 字段）。三个 relation_types 分别是：

  • RELATED_NO_ADMISSION：地点相关，但商品选项不包含门票或门票无关。例如，如果相应位置是城市游览中突出显示的广场。

  • ADMISSION_TICKET：关系授予对相关地点的入场权限。

  • SUPPLEMENTARY_ADDON：关系声明了不会将用户带到相关位置的附加服务。例如停车罚单、临时展览。

示例

relation_type 示例
RELATED_NO_ADMISSION 在埃菲尔铁塔周围进行徒步游览，但不进入铁塔内部。 乘坐直升机环绕哈利法塔观光。
ADMISSION_TICKET 动物园门票，可包含其他附加服务。
SUPPLEMENTARY_ADDON 免排队门票，不含门票的语音导览。
不相关 乘船游览，从远处观看 POI。 游览的起点或可购买门票的旅游办事处。

每个商品 option 还可能具有 meeting_point，用于指定起始位置不明确且必须确定的特定旅游类型（例如导游陪同的旅游）。

如何申请添加新的景点

如果您提供景点官方门票，但发现您合作的某个景点未显示在 Google 推荐活动中，您可以填写 TTD 新 POI 请求表单，请求将该 POI 添加到推荐活动中。

在处理传入 Feed 时，Google 会尝试将以文本字符串形式提供的位置提示与代表这些位置的 Google 内部实体（称为兴趣点 [POI]）进行匹配。

从广义上讲，POI 可以定义为特定位置（坐标）上的命名图钉。在“推荐活动”的背景下，相关示例包括旅游运营商和旅游景点；不过，一般来说，地图注点可以是 Google 已知的任何具有名称和位置的场所。

位置匹配是指将相关位置（以文本提示的形式）与 Google 已知的地图注点进行匹配的过程（如果 Google 数据库中存在此类地图注点）。

您可以根据位置数据的来源、与供应商的合同要求以及您希望对匹配流程的控制程度，通过多种方式向 Google 发送相关位置信息。

系统支持以下提示类型（按偏好程度排序）：

提示类型

类型 说明 建议用法
商家资料 ID 唯一标识 Google 上的商家。

只能直接从企业主处获取，具体方法是使用企业主的商家资料高级设置页面，如 高级商家资料设置中所述。

它会映射到 Google 上代表相应商家的 POI。只有在商家营业地点通过 Google 验证后，映射才会成功。

除了地图注点之外，此格式还支持上门服务商家和混合型商家类型，具体定义请参阅如何在 Google 上使用服务区域。
  • 合作伙伴与企业主有直接的业务关系。
  • 对于上门服务商家或混合型商家，这是发送此类位置信息的首选方式。
地点信息 POI 的结构化表示形式，为地点名称、地址组成部分和电话号码、网站和坐标等其他提示提供单独的字段。

如果无法从地图注点所有者处获取商家资料 ID，建议采用此方法。
  • 位置信息以地址格式从供应商或数据所有者处获取，例如使用面向供应商的工具。
  • 相应地点没有确切的地址，但可以通过名称和坐标来识别，例如位于偏远地区（如沙漠或无名道路）的景点或旅游运营商。
  • 如果可以，请优先使用此格式，而不是使用 Places API 将地址与地点 ID 进行匹配，以便 Google 可以使用电话号码或网站等其他信息来提高匹配准确性。
地点 ID 唯一标识 Google 上的 POI。

您可以使用 Places API 端点（例如地点搜索或地点自动补全）获取地点 ID，也可以手动使用 Things to Do Center 中的“查找匹配地点”工具获取地点 ID。
  • 位置信息由供应商或数据所有者通过面向供应商的界面工具提供，该工具可能使用地点自动补全功能，以便数据所有者从候选地点列表中选择正确的匹配项。
  • 您希望更好地控制匹配流程，或者不愿意分享原始地址信息。
  • 如果无法从地图注点所有者处获取商家资料 ID，并且您希望使用 Places API 在本地将地址与地图注点进行匹配，而不是将原始地点信息发送给 Google，那么此方法是首选方法。
纬度和经度 粗略地标识地理区域或地缘政治区域，例如城市、地区或旅游目的地。
  • 如果您想发送不代表任何特定 POI 的大致位置，请使用此格式。例如， 当您想将某个产品与某个城市或市行政区相关联，以便该产品可以在“推荐活动广告”中触发时。
  • 此格式不适合表示 POI。如需使用坐标发送 POI 位置，请使用地点信息格式。
地址 表示 POI 位置，格式为非结构化单行地址，可选择性地包含地点名称。

已弃用。
自 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. 从 Feed 中舍弃现有的 address 字段
    4. 前往第 3 步
  2. 如果您拥有的地址数据是结构化数据，请执行以下操作：
    1. 将商家名称添加到 place_info/name 字段
    2. 添加地址信息，例如 place_info/structured_address 中的 street_address、postal_address。
    3. 从 Feed 中舍弃现有的 address 字段
    4. 前往第 3 步
  3. 添加 website_url 和 phone_number 等其他数据，以提高匹配准确率