商品 Feed 提供了多种方法供您指定与商品关联的地图注点。当用户搜索相关的地图注点或目的地时,Google 会使用这些信息向用户呈现商品。
每个产品 option
都可以使用 related_location
字段(包含 RelatedLocation
对象列表)指定一个或多个与选项相关的地图注点 (POI)。每个 RelatedLocation
对象均包含一个 location
,用于描述相关地图注点,以及一个 relation_type
,用于描述地图注点与商品 option
之间的关系。
相关营业地点和 Relationship_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 新地图注点申请表单,申请将该地图注点添加到推荐活动中。
如何将相关营业地点传递给 Google
处理传入的 Feed 时,Google 会尝试将以文本字符串形式提供的位置提示与表示这些营业地点的 Google 内部实体(称为地图注点 [POI])进行匹配。
可以将地图注点粗略定义为特定位置(坐标)上的命名图钉。在推荐活动中,相关示例包括旅行社和旅游景点;不过,一般来说,地图注点可以是 Google 已知的名称和地点的任何场所。
位置匹配是指以文本提示的形式将相关位置与 Google 已知的地图注点(如果 Google 数据库中存在该地图注点)进行匹配的过程。
向 Google 发送相关位置信息的方法有多种,具体取决于位置数据的来源、与供应商的合同要求,以及您希望在匹配流程方面拥有的控制力。
支持以下提示类型(按优先顺序):
提示类型
类型 | 说明 | 建议用法 |
---|---|---|
商家资料 ID |
在 Google 上唯一标识商家。
您只能通过企业主的“商家资料高级设置”页面直接向该企业主获取该 ID,如 高级商家资料设置中所述。 映射到在 Google 上代表商家的地图注点。只有营业地点经 Google 验证后,映射才能成功。 除了地图注点之外,此格式还支持如何在 Google 上使用上门服务区域中定义的上门服务商家和混合型商家类型。 |
|
地点信息 |
地图注点的结构化表示,为地点名称、地址组成部分和其他提示(例如电话号码、网站和坐标)提供单独的字段。
当从地图注点所有者处获取商家资料 ID 时,这是首选方法。 |
|
地点 ID |
在 Google 上唯一标识某个地图注点。
可以使用 Places API 端点(例如地点搜索或地点自动补全)来获取数据,也可以使用 Things to Do Center 中的“查找营业地点匹配”工具手动获取。 |
|
纬度和经度 | 大致确定一个地理或地缘政治区域,例如城市、市行政区或旅游目的地。 |
|
地址 |
以非结构化的单行地址表示地图注点位置,可以选择包含地点名称。
已废弃。 从 2024 年 5 月 1 日起,我们将不再支持这种格式。 |
|
示例
// 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
字段:
- 如果您的地址数据是非结构化数据,请执行以下操作:
- 将商家名称添加到
place_info/name
字段 - 将不含商家名称的地址放入
place_info/unstructured_address
中 - 从 Feed 中删除现有的“
address
”字段 - 转到第 3 步
- 将商家名称添加到
- 如果您的地址数据是结构化的,请执行以下操作:
- 将商家名称添加到
place_info/name
字段 - 在
place_info/structured_address
中添加street_address
、postal_address
等地址信息。 - 从 Feed 中删除现有的“
address
”字段 - 转到第 3 步
- 将商家名称添加到
- 添加其他数据(例如
website_url
和phone_number
),以提高匹配准确性