地理位置和地图注点

商品 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 上的地图注点。

您可以使用 Places API 端点（例如地点搜索或地点自动补全）获取地点 ID，也可以手动使用推荐活动中心中的“查找匹配地点”工具获取地点 ID。
  • 位置信息是通过面向供应商的界面工具从供应商或数据所有者处获取的，例如，该工具可能会使用地点自动补全功能，以便数据所有者从可能的候选地点列表中选择正确的匹配项。
  • 您希望更好地控制匹配流程，或者不愿分享原始地址信息。
  • 如果无法从地图注点所有者处获取商家资料 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 等其他数据，以提高匹配准确性