位置和地图注点

商品 Feed 提供了多种方法供您指定与商品关联的地图注点。当用户搜索相关的地图注点或目的地时,Google 会使用这些信息向用户呈现商品。

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

仅当产品选项除了实地参观之外还提供其他有意义的地理位置体验时,才应标记为“相关”。“有意义的”的定义可能因地点而异,但通常不应标记为“相关”的内容包括在乘船游览或巴士观光等期间看到地图注点的情况,或游览的会面地点(请改用 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 端点(例如地点搜索或地点自动补全)来获取数据,也可以使用 Things to Do Center 中的“查找营业地点匹配”工具手动获取。
  • 位置信息是通过面向供应商的界面工具获取的,该工具可能会使用地点自动补全功能,以便数据所有者从可能的候选对象列表中选择正确的匹配项。
  • 您更希望更好地控制匹配流程,或者不想分享原始地址信息。
  • 如果从地图注点所有者处获取商家资料 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_addresspostal_address 等地址信息。
    3. 从 Feed 中删除现有的“address”字段
    4. 转到第 3 步
  3. 添加其他数据(例如 website_urlphone_number),以提高匹配准确性