ข้อมูลอ้างอิงด่วนของ Places API (เดิม)

คุณจะเปิดใช้ Places API (เดิม) สำหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่ไม่ได้อีกต่อไปตั้งแต่เดือนตุลาคม 2026 โปรเจ็กต์ที่มีอยู่จะยังคงได้รับการสนับสนุนอย่างเต็มรูปแบบ หากต้องการใช้ฟีเจอร์ใหม่และประสิทธิภาพที่ดีขึ้น ให้ย้ายข้อมูลไปยัง Places API (ใหม่)

Places API (เดิม): ข้อเท็จจริงสำคัญ

  • ผลิตภัณฑ์: Places API (เดิม)
  • หรือที่เรียกว่า Places API (บริการเว็บเดิม), บริการเว็บ Places API (maps/api/place)
  • หมวดหมู่: สถานที่
  • แพลตฟอร์ม: บริการผ่านเว็บ (REST)
  • ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
  • ระยะการเปิดตัว: GA
  • วงจร: เดิม
  • แทนที่ด้วย: Places API (ใหม่)
  • ภาพรวม: ภาพรวมของ Places API (เดิม)

Places API (เดิม): กรณีที่ควรใช้

ใช้ Places API (เดิม) ในกรณีต่อไปนี้

  • คุณดูแลรักษาโปรเจ็กต์ที่มีอยู่ซึ่งเปิดใช้ Places API (เดิม) และเรียกใช้ปลายทาง maps.googleapis.com/maps/api/place อยู่แล้ว
  • คุณต้องมีการเรียกใช้ Find Place, การค้นหาในบริเวณใกล้เคียง, การค้นหาข้อความ, Details, Photos หรือ Autocomplete (เดิม) อยู่แล้วเพื่อให้ทำงานต่อไปได้ขณะย้ายข้อมูล

อย่าใช้ Places API (เดิม) ในกรณีต่อไปนี้

  • คุณกำลังเริ่มโปรเจ็กต์ Google Cloud ใหม่ ตั้งแต่เดือนตุลาคม 2026 เป็นต้นไป คุณจะเปิดใช้ Places API (เดิม) สำหรับโปรเจ็กต์ใหม่ไม่ได้ โปรดใช้ Places API (ใหม่) แทน
  • คุณต้องการฟีเจอร์ใหม่, การตรวจสอบสิทธิ์ OAuth หรือมาสก์ฟิลด์ในการค้นหาในบริเวณใกล้เคียงและการค้นหาข้อความ เพื่อให้คุณจ่ายเฉพาะฟิลด์ที่ขอ โปรดใช้ Places API (ใหม่) แทน
  • คุณต้องใช้การค้นหาสถานที่ (เดิม) หรือการเติมข้อความค้นหาอัตโนมัติ (เดิม) ในโค้ดใหม่ โดยจะแทนที่ด้วยการค้นหาข้อความ (ใหม่) และการเติมข้อความอัตโนมัติ (ใหม่) โปรดใช้ Places API (ใหม่) แทน

Places API (เดิม): การตั้งค่า

Places API (เดิม): ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: หากคำขอรายละเอียดสถานที่ (เดิม) ละเว้นพารามิเตอร์ fields หรือไม่ระบุช่องใดๆ API จะแสดงผลช่องทั้งหมดและเรียกเก็บเงินจากคุณสำหรับช่องทั้งหมด วิธีแก้ไข: ตั้งค่าพารามิเตอร์ fields เสมอ หรือย้ายข้อมูลไปยังรายละเอียดสถานที่ (ใหม่) โดยใช้มาสก์ฟิลด์ ดู /maps/documentation/places/web-service/legacy/details
  • ปัญหา: การค้นหาในบริเวณใกล้เคียง (เดิม) และการค้นหาข้อความ (เดิม) ไม่รองรับการระบุช่องที่จะแสดงผล โดยจะแสดงผลชุดฟิลด์คงที่ (ชุดย่อยของฟิลด์รายละเอียดสถานที่) และทริกเกอร์ SKU ข้อมูลพื้นฐาน ข้อมูลติดต่อ และข้อมูลบรรยากาศเสมอ วิธีแก้ไข: ย้ายข้อมูลไปยังการค้นหาในบริเวณใกล้เคียง (ใหม่) หรือการค้นหาข้อความ (ใหม่) โดยใช้มาสก์ฟิลด์ หรือใช้ค้นหาสถานที่ (เดิม) โดยใช้พารามิเตอร์ fields เพื่อขอและชำระเงินสำหรับฟิลด์ที่ต้องการเท่านั้น ดู /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku
  • ปัญหา: photo_reference ไม่สามารถแคชได้และอาจหมดอายุ ดังนั้นการอ้างอิงที่จัดเก็บไว้จึงหยุดทำงาน วิธีแก้ไข: รับ photo_reference ใหม่จากการตอบกลับของรายละเอียดสถานที่, ค้นหาสถานที่, การค้นหาในบริเวณใกล้เคียง หรือการค้นหาข้อความก่อนขอรูปภาพ ดู /maps/documentation/places/web-service/legacy/photos
  • ปัญหา: การเรียกใช้ Places API (เดิม) จากโปรเจ็กต์ที่ไม่ได้เปิดใช้จะแสดงผล REQUEST_DENIED พร้อมข้อความแสดงข้อผิดพลาด "คุณกำลังเรียกใช้ API เดิมซึ่งไม่ได้เปิดใช้สำหรับโปรเจ็กต์ของคุณ..." (LegacyApiNotActivatedMapError) ตั้งแต่เดือนตุลาคม 2026 เป็นต้นไป คุณจะเปิดใช้ Places API (เดิม) สำหรับโปรเจ็กต์ใหม่ไม่ได้ วิธีแก้ไข: ใช้ Places API (ใหม่) สำหรับโปรเจ็กต์ใหม่และย้ายข้อมูลแอปที่มีอยู่ ในระหว่างการย้ายข้อมูล คุณสามารถขอเปิดใช้งาน API เดิมในระยะสั้นได้ผ่านแบบฟอร์มความคิดเห็นในหน้าเดิม ดู /maps/legacy#LegacyApiNotActivatedMapError

Places API (เดิม): ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว