การย้ายข้อมูลช่องสถานที่ตั้ง (open_now, utc_offset)

เราเลิกใช้งานฟิลด์สถานที่ opening_hours.open_now และ utc_offset ตั้งแต่วันที่ 20 พฤศจิกายน 2019 และจะปิดให้บริการในวันที่ 20 กุมภาพันธ์ 2021 ระบบเลิกใช้งานฟิลด์เหล่านี้ใน Places Library, Maps JavaScript API เท่านั้น คู่มือนี้แสดงวิธีอัปเดตโค้ดเพื่อ หยุดใช้ช่องเหล่านี้

opening_hours.open_now ฟิลด์

ส่วนนี้จะแสดงวิธีอัปเดตฟังก์ชันนี้สำหรับคำขอ Places แต่ละประเภท

คำขอรายละเอียดสถานที่

ช่อง opening_hours.open_now จะแทนที่ด้วย opening_hours.isOpen() เมธอด

สําหรับคําขอรายละเอียดสถานที่ แทนที่จะขอ opening_hours.open_now ในพารามิเตอร์คำขอ fields ให้ใส่ opening_hours และ utc_offset_minutes ในพารามิเตอร์คำขอ fields จากนั้นเรียกใช้เมธอด opening_hours.isOpen() ในออบเจ็กต์ google.maps.places.PlaceResult ที่ส่งคืน เพื่อตรวจสอบว่าสถานที่เปิดอยู่หรือไม่ ตัวอย่างต่อไปนี้แสดงคำขอรายละเอียดสถานที่ซึ่งระบุว่าสถานที่ เปิดอยู่หรือไม่

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.
    }
});

คำขอ Find Place

สำหรับคำขอ Find Place ไม่มีการแทนที่ฟิลด์ opening_hours.open_now เราขอแนะนำให้ส่งคำขอรายละเอียดสถานที่ เพื่อรับข้อมูล opening_hours

คำขอการค้นหาในบริเวณใกล้เคียงและการค้นหาข้อความ

สำหรับคำขอ Nearby Search และ Text Search คุณสามารถใช้พารามิเตอร์คำขอ openNow ซึ่งมีผลเป็นการกรองผลลัพธ์ให้รวมเฉพาะ สถานที่ที่เปิดอยู่เท่านั้น

  • openNow:false จะแสดงสถานที่ทั้งหมด
  • openNow:true จะแสดงเฉพาะสถานที่ที่เปิดให้บริการอยู่ในขณะนี้

หากต้องการแสดงสถานที่ทั้งหมดและระบุสถานะ openNow ให้ส่งคำขอก่อนโดยใช้ openNow:false เพื่อรับสถานที่ทั้งหมด จากนั้นส่งคำขอโดยใช้ openNow:true เพื่อ รับเฉพาะสถานที่ที่เปิดอยู่ จากนั้นผสานคำตอบ

utc_offset ฟิลด์

ในคำขอรายละเอียดสถานที่ utc_offset จะแทนที่ด้วยฟิลด์ utc_offset_minutes เพียงแทนที่อินสแตนซ์ของ utc_offset ด้วย utc_offset_minutes ในfields พารามิเตอร์คำขอ และเมื่ออ่านข้อมูลนี้จาก PlaceResult