使用地点 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 进行访问。