地点字段迁移(open_now、utc_offset)

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

“地点”字段 opening_hours.open_nowutc_offset 自 2019 年 11 月 20 日起弃用,自 2021 年 2 月 20 日起停用。这些字段仅在 Maps Library 和 Maps JavaScript API 中已弃用。本指南介绍了如何更新代码以停止使用这些字段。

opening_hours.open_now 字段

本部分介绍了如何为每种类型的地点请求更新此功能。

地点详情请求

opening_hours.open_now 字段已替换为 opening_hours.isOpen() 方法。

对于地点详情请求,而不是在 fields 请求参数中请求 opening_hours.open_now,请在 fields 请求参数中添加 opening_hoursutc_offset_minutes,然后对返回的 google.maps.places.PlaceResult 对象调用 opening_hours.isOpen() 方法,以检查地点是否处于打开状态。以下示例显示了确定地点是否营业的“地点详情”请求:

new google.maps.places.PlacesService(attrContainer).getDetails({
  placeId: '...',
  fields: ['opening_hours','utc_offset_minutes'],
  }, function (place, status) {
    if (status !== 'OK') return; // something went wrong
    const isOpenAtTime = place.opening_hours.isOpen(new Date('December 17, 2020 03:24:00'));
    if (isOpenAtTime) {
        // We know it's open.
    }

    const isOpenNow = place.opening_hours.isOpen();
    if (isOpenNow) {
        // We know it's open.
    }
});

查找地点请求

对于查找地点请求opening_hours.open_now 字段没有替代项。我们建议您发出地点详情请求以获取 opening_hours 信息。

附近地点搜索和文字搜索请求

对于“附近搜索”和“文本搜索”请求,您可以使用 openNow 请求参数,该参数用于过滤结果,使其仅包含当前打开的地点。

  • openNow:false 会返回所有地点。
  • openNow:true 仅返回当前营业的地点。

如需列出所有地点并指示 openNow 状态,请先使用 openNow:false 发出请求以获取所有地点,然后使用 openNow:true 发出请求以仅获取营业中的地点。然后合并回复。

utc_offset 字段

在“地点详情”请求中,utc_offset 字段会被替换为 utc_offset_minutes 字段。只需在 fields 请求参数中以及从 PlaceResult 读取此信息时将 utc_offset 替换成 utc_offset_minutes 即可。