ข้อมูลอ้างอิงฉบับย่อของ Places API (ใหม่)

Places API (ใหม่) เป็นบริการบนเว็บที่แสดงข้อมูลตำแหน่ง JSON เกี่ยวกับสถานที่ตั้ง สถานที่ตั้งทางภูมิศาสตร์ และจุดที่น่าสนใจ โดยรองรับการค้นหาข้อความ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่), การเติมข้อความอัตโนมัติ (ใหม่), รายละเอียดสถานที่ (ใหม่) และรูปภาพสถานที่ (ใหม่)

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

  • ผลิตภัณฑ์: Places API (ใหม่)
  • หรือที่เรียกว่า Places API
  • หมวดหมู่: สถานที่
  • แพลตฟอร์ม: บริการผ่านเว็บ (REST)
  • ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Places API (ใหม่)
  • ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก โปรเจ็กต์ที่มีที่อยู่สำหรับการเรียกเก็บเงินใน EEA จะใช้ข้อกำหนดในการให้บริการของ Google Maps Platform ใน EEA (มีผลบังคับใช้ตั้งแต่วันที่ 8 กรกฎาคม 2025) ซึ่งเนื้อหา Places API นอกเหนือจากละติจูด ลองจิจูด และรหัสสถานที่จะใช้กับแผนที่ใดๆ ไม่ได้ ยกเว้นผ่าน Places UI Kit ข้อมูลสรุปเกี่ยวกับสถานที่ รีวิว และพื้นที่ที่ทำงานด้วยระบบ AI พร้อมให้บริการในภาษาและภูมิภาคที่รองรับเท่านั้น

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

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

  • คุณต้องค้นหาสถานที่จากเซิร์ฟเวอร์ด้วยคำค้นหาที่เป็นข้อความ (การค้นหาข้อความ (ใหม่)) หรือรอบๆ สถานที่ (การค้นหาในบริเวณใกล้เคียง (ใหม่))
  • คุณต้องการการคาดคะเนสถานที่หรือคำค้นหาแบบพิมพ์ล่วงหน้าจากแบ็กเอนด์ผ่าน Autocomplete (ใหม่)
  • คุณมีรหัสสถานที่และต้องการรายละเอียด เช่น ที่อยู่ หมายเลขโทรศัพท์ คะแนน รีวิว หรือรูปภาพ
  • คุณต้องการข้อมูลสรุปเกี่ยวกับสถานที่ รีวิว หรือพื้นที่ที่ทำงานด้วยระบบ AI สำหรับสถานที่หนึ่งๆ

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

  • คุณกำลังสร้างแอป Android แบบเนทีฟ โปรดใช้ Places SDK สำหรับ Android แทน
  • คุณกำลังสร้างแอป iOS แบบเนทีฟ ให้ใช้ Places SDK สำหรับ iOS แทน
  • คุณกำลังสร้างเว็บแอปบนเบราว์เซอร์และต้องการให้โหลดไลบรารี Places ใน JavaScript โปรดใช้ Maps JavaScript API แทน

Places API (ใหม่): การตั้งค่า

แพ็กเกจ Places API (ใหม่) อย่างเป็นทางการ

  • npm: @googlemaps/places
  • pypi: google-maps-places
  • ไปที่: cloud.google.com/go/maps

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

  • ปัญหา: รายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ไม่มีรายการช่องที่แสดงผลเริ่มต้น คำขอที่ไม่มีมาสก์ช่องจะแสดงข้อผิดพลาด วิธีแก้ไข: ส่งฟิลด์มาสก์การตอบกลับพร้อมพารามิเตอร์ fields หรือ $fields หรือส่วนหัว X-Goog-FieldMask ดู /maps/documentation/places/web-service/choose-fields
  • ปัญหา: หากละเว้นหรือใช้โทเค็นเซสชันการเติมข้อความอัตโนมัติ (ใหม่) ซ้ำหลังจากเซสชันสิ้นสุดลง ระบบจะเรียกเก็บเงินคำขอแต่ละรายการแยกกันเป็น SKU: คำขอเติมข้อความอัตโนมัติ วิธีแก้ไข: สร้างโทเค็นของเซสชันใหม่ (แนะนำให้ใช้ UUID v4) สำหรับแต่ละเซสชัน และสิ้นสุดด้วยคำขอรายละเอียดสถานที่ (ใหม่) หรือ Address Validation ดู /maps/documentation/places/web-service/place-session-tokens
  • ปัญหา: โค้ดที่มีอยู่หรือโค้ดที่ AI สร้างขึ้นซึ่งเรียกใช้ Places API (เดิม) หรือ Maps JavaScript API PlacesService ในโปรเจ็กต์ที่ไม่ได้เปิดใช้ API เดิมจะดำเนินการไม่สำเร็จพร้อมข้อผิดพลาด LegacyApiNotActivatedMapError วิธีแก้ไข: ย้ายข้อมูลการเรียกไปยัง Places API (ใหม่) และใส่มาสก์ฟิลด์ที่จำเป็น ดู /maps/legacy#LegacyApiNotActivatedMapError
  • ปัญหา: รหัสสถานที่ที่จัดเก็บไว้อาจล้าสมัย จากนั้นรายละเอียดสถานที่ (ใหม่) จะแสดงผล NOT_FOUND (HTTP 404) และรหัสที่ผิดรูปแบบหรือถูกตัดให้สั้นลงจะแสดงผล HTTP 400 INVALID_ARGUMENT วิธีแก้ไข: รีเฟรชรหัสสถานที่ที่จัดเก็บไว้ซึ่งมีอายุมากกว่า 12 เดือนด้วยคำขอรายละเอียดสถานที่ (ใหม่) ที่ขอเฉพาะช่อง id (ไม่มีค่าใช้จ่าย) ดู /maps/documentation/places/web-service/place-id#refresh-id

สิ่งที่คุณทำได้ด้วย Places API (ใหม่)

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ

Places API (ใหม่): Generative AI

Places API (ใหม่): Places