คุณจะเปิดใช้ 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-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ 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 (เดิม): ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
- ฟิลด์การตอบกลับ
permanently_closed: เลิกใช้งานตั้งแต่วันที่ 26 พฤษภาคม 2020 การแทนที่: ช่องbusiness_statusดูคำแนะนำในการย้ายข้อมูล - ช่องการตอบกลับ
reference: เลิกใช้งานตั้งแต่วันที่ 3 กันยายน 2019 การแทนที่: ช่องplace_idดูคำแนะนำในการย้ายข้อมูล - พารามิเตอร์คำขอการค้นหาในบริเวณใกล้เคียง (เดิม)
name: เลิกใช้งานแล้ว รายการทดแทน: พารามิเตอร์keywordดูคำแนะนำในการย้ายข้อมูล