本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
使用地点 ID
搜索地点会返回结果列表。对于该结果,大多数结果都包含一个 PlaceId
。您可以在 GetPlace
操作中使用 PlaceId
来返回有关该地点的信息(包括名称、地址、位置或其他详细信息)。
注意
使用SearchPlaceIndexForSuggestions将返回使用任何数据源创建的任何地点索引的PlaceId
结果。PlaceId
仅当使用的数据源为 HERE 时,使用SearchPlaceIndexForText或才SearchPlaceIndexForPosition会返回。
每个 PlaceId
都唯一地定义了它所指的地点,但是随着时间的推移,根据上下文,一个地点可以有多个 PlaceId
。以下规则描述了 PlaceId
的独特性和寿命。
-
您发出的调用中
PlaceId
返回的值特定于您 AWS 账户的、该 AWS 地区以及您的PlaceIndex
资源中的数据提供商。GetPlace
只有当这三个属性与创建的原始调用匹配时,才会找到结果PlaceId
。 -
当某个地点的数据发生变化时,该地点的
PlaceId
将发生变化。例如,当它所指的企业搬迁地点或更改名称时。 -
当后端服务进行更新时,重复搜索调用返回的
PlaceId
可能会发生变化。PlaceId
将继续找到较旧的,但是新的搜索调用可能会返回不同的 ID。
PlaceId
是一个字符串。PlaceId
的长度没有具体限制。以下是有效的 PlaceId
的示例。
AQAAAIAADsn2T3KdrRWeaXLeVEyjNx_JfeTsMB0NVCEAnAZoJ-o3nqdlJZAdgcT2oWi1w9pS4wXXOk3O1vsKlGsPyHjV4EJxsu289i3hVO_BUPgP7SFoWAi8BW2v7LvAjQ5NfUPy7a1v9ajT3feIqcUZszWSTqKbJHFYvQqW7wdqhpQq3Wy-et39ZQDWSPLZUzgcjN-6VD2gyKkH0Po7gSm8YSJNSQ
对于数据已更改的地点(例如,营业地点已停业),使用 PlaceId
调用 GetPlace
将导致 404
、ResourceNotFound
错误。GetPlace
使用无效的PlaceId
,或者一个脱离上下文(例如从另一个 AWS 账户上下文中调用)调用400
将返回ValidationException
错误。
虽然您可以在后续请求中使用 placeID,但 placeID 并不是永久标识符,并且在连续的 API 调用之间,ID 可能会发生变化。请查看每个数据提供者的以下 placeID 行为:
-
Esri:地点 ID 将至少每季度更改一次。这些变化的典型时间段为三月、六月、九月和十二月。地点 ID 也可能在典型的季度变化之间发生变化,但频率要低得多。
-
这里:我们建议您缓存数据的时间不超过一周,以保持数据最新状态。你可以假设只有不到 1% 的ID移位会随着发布而释放,大约每周1-2次。
-
Grab:在以下情况下,地点 ID 可能会过期或失效。
数据操作:Grab Map Ops 可能会根据实际情况从 Grab POI 数据库中删除 POI,例如在现实世界中被关闭、被检测为重复的 POI 或包含不正确的信息。Grab 将每周将数据同步到 Waypoint 环境。
插值 POI:插值 POI 是在处理请求时实时生成的临时 POI,它将在响应的字段中标记为派生。
place.result_type
插值后的兴趣点信息将保留至少 30 天,这意味着您可以在 30 天内从 “地点详情 API” 中按地点 ID 获取 POI 详情。30 天后,插值后的 POI(包括地点 ID 和详情)可能会过期,且无法通过 “地点详情” API 进行访问。