位置和地图注点

商品 Feed 提供了多种方式来指定与商品相关的兴趣点。当用户搜索相关地图注点或目的地时，Google 会使用这些信息来帮助向用户展示商品。

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

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

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

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

  • SUPPLEMENTARY_ADDON：关系声明了不会将用户引导至相关位置的其他服务。例如停车票、临时展览。

示例

relation_type 示例
RELATED_NO_ADMISSION 埃菲尔铁塔周边漫步观光之旅，无需门票。 乘坐直升机环绕哈利法塔飞行。
ADMISSION_TICKET 动物园门票，可能包含额外的附加服务。
SUPPLEMENTARY_ADDON 无需输入即可跳过线条，无需输入即可使用语音导览。
不相关 从远处观赏地图注点的游船之旅。 游览的起点或可购买门票的游览办公室。

对于起点不明确且必须确定的特定游览类型（例如导览游），每个商品 option 还可以有一个 meeting_point。

如何请求添加新景点

如果您提供的是景点的官方门票，并且发现您合作的某个景点未在 Google 推荐活动中，则可以填写 TTD 新地图注点申请表单，请求将该地图注点添加到推荐活动中。

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

地图注点可以粗略地定义为特定位置（坐标）上的命名图钉。在推荐活动的上下文中，相关示例包括旅行社和旅游景点；不过，一般来说，地图注点可以是 Google 知道名称和位置的任何场所。

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

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

支持以下提示类型（按首选顺序）：

提示类型

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

您只能通过商家资料的高级设置页面直接向商家所有者索要此 ID，如 商家资料高级设置中所述。

它会映射到 Google 上代表相应商家的地图注点。只有当商家的位置信息已通过 Google 验证后，映射才会成功。

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

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

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

已废弃。
自 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 等其他数据，以提高匹配准确性