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.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API, OAuth 2.0
- เริ่มต้นใช้งาน: ตั้งค่า Places API (ใหม่)
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Places API (ใหม่)
- ราคา: การใช้งานและการเรียกเก็บเงินของ Places API (ใหม่)
- นโยบาย: นโยบาย Places API (ใหม่)
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Places API (ใหม่)
แพ็กเกจ Places API (ใหม่) อย่างเป็นทางการ
- npm:
@googlemaps/places - pypi:
google-maps-places - ไปที่:
cloud.google.com/go/maps
Places API (ใหม่): สินค้าที่เกี่ยวข้อง
- แทนที่: Places API (เดิม)
- มักใช้ร่วมกับ: Geocoding API, Routes API, Address Validation API
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 400INVALID_ARGUMENTวิธีแก้ไข: รีเฟรชรหัสสถานที่ที่จัดเก็บไว้ซึ่งมีอายุมากกว่า 12 เดือนด้วยคำขอรายละเอียดสถานที่ (ใหม่) ที่ขอเฉพาะช่องid(ไม่มีค่าใช้จ่าย) ดู /maps/documentation/places/web-service/place-id#refresh-id
สิ่งที่คุณทำได้ด้วย Places API (ใหม่)
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
Places API (ใหม่): Generative AI
- แสดงข้อมูลสรุปที่ทำงานด้วยระบบ AI ของรีวิวจากผู้ใช้สำหรับตัวระบุ Google Place ที่ระบุ
- แสดงข้อมูลสรุปเกี่ยวกับสถานที่ซึ่งทำงานด้วยระบบ AI ของพื้นที่และสิ่งอำนวยความสะดวกรอบๆ ตัวระบุ Google Places ที่ระบุสำหรับสถานีชาร์จรถยนต์ไฟฟ้า
Places API (ใหม่): Places
- แสดงผลรายการสถานที่และรายละเอียดสถานที่ตามสตริงการค้นหา
- แสดงรายการสถานที่และรายละเอียดสถานที่ใกล้กับสถานที่หนึ่งๆ
- แสดงผลการเติมข้อความอัตโนมัติเกี่ยวกับสถานที่ตามสตริงการค้นหา
- แสดงข้อมูลโดยละเอียดเกี่ยวกับสถานที่ที่เจาะจง
- แสดงรูปภาพของสถานที่ที่เจาะจง หมายเหตุ: แสดงการระบุแหล่งที่มาของผู้เขียนรูปภาพแต่ละรูป (ชื่อของผู้เขียนที่ลิงก์กับ URI โปรไฟล์) พร้อมกับรูปภาพ นโยบาย Places สำหรับแต่ละแพลตฟอร์มกำหนดให้ต้องระบุข้อมูลนี้ เช่น /maps/documentation/javascript/policies#photo-attributions และ /maps/documentation/places/web-service/policies#photos-and-review
- ปรับขนาดรูปภาพของสถานที่
- แสดงคะแนนและรีวิวของสถานที่ที่เฉพาะเจาะจง หมายเหตุ: ในเว็บเซอร์วิส Places API (ใหม่) รายละเอียดสถานที่เป็นคำขอ HTTP GET ไปยัง https://places.googleapis.com/v1/places/{placeId} ที่มี X-Goog-FieldMask (เช่น rating,userRatingCount,reviews) ส่วนการค้นหาข้อความ การค้นหาในบริเวณใกล้เคียง และการเติมข้อความอัตโนมัติจะใช้ POST ใน Android ให้ส่ง Place.Field.RATING, USER_RATING_COUNT และ REVIEWS ไปยัง PlacesClient.fetchPlace() ใน iOS ให้ส่ง GMSPlacePropertyRating, GMSPlacePropertyUserRatingsTotal และ GMSPlacePropertyReviews ใน GMSFetchPlaceRequest
- ระบุฟิลด์ข้อมูลที่รวมอยู่ในการตอบกลับข้อมูลสถานที่
- ระบุประเภทสถานที่ที่จะรวมไว้ในการตอบกลับข้อมูลสถานที่
- แสดงผล URI เพื่อเปิดหน้ารายละเอียดสถานที่ใน Google Maps สำหรับสถานที่หนึ่งๆ
- แสดงผล URI เพื่อเปิดหน้าเส้นทางใน Google Maps สำหรับสถานที่
- แสดงผล URI เพื่อเปิดหน้าเขียนรีวิวใน Google Maps สำหรับสถานที่
- แสดงผล URI เพื่อเปิดหน้าอ่านรีวิวใน Google Maps สำหรับสถานที่
- แสดงผล URI เพื่อเปิดหน้ารูปภาพใน Google Maps สำหรับสถานที่
- แสดงข้อมูลสรุปภาพรวมโดย AI สำหรับสถานที่ที่เฉพาะเจาะจง
- แสดงข้อมูลสรุปเกี่ยวกับพื้นที่ที่ทำงานด้วยระบบ AI ซึ่งอธิบายสถานที่ในพื้นที่รอบๆ สถานที่หนึ่งๆ
- แสดงข้อมูลเกี่ยวกับสถานที่ตามสตริงการค้นหาที่อยู่ตามเส้นทางที่กำหนดไว้ล่วงหน้า
- แสดงระยะทาง ระยะเวลาเดินทาง และ URI เส้นทางไปยังสถานที่ที่ค้นหาด้วยข้อความจากชุดพิกัดละติจูด/ลองจิจูด
- แสดงระยะทาง ระยะเวลาเดินทาง และ URI เส้นทางไปยังสถานที่ใกล้เคียงจากชุดพิกัดละติจูด/ลองจิจูด
- แสดงผลระยะทาง ระยะเวลาเดินทาง และ URI ของเส้นทางระหว่างจุดเริ่มต้นของเส้นทางที่กำหนดไว้ล่วงหน้ากับสถานที่แต่ละแห่งที่แสดงผลตามสตริงการค้นหา ซึ่งอยู่ตามเส้นทางด้วย
- แสดงผลระยะทาง ระยะเวลาเดินทาง และ URI ของเส้นทางระหว่างสถานที่แต่ละแห่งที่แสดงผลตามสตริงการค้นหา ซึ่งอยู่ตามเส้นทางที่กำหนดไว้ล่วงหน้าและจุดหมายของเส้นทางด้วย