Places SDK สำหรับ Android ช่วยให้แอป Android เข้าถึงฐานข้อมูลข้อมูลสถานที่และธุรกิจของ Google ผ่าน Place Autocomplete, รายละเอียดสถานที่, การค้นหาในบริเวณใกล้เคียง, การค้นหาข้อความ และ Place Photos Places SDK สำหรับ Android (ใหม่) เป็นเวอร์ชันปัจจุบันและขึ้นอยู่กับ Places API (ใหม่)
Places SDK สำหรับ Android: ข้อมูลสำคัญ
- ผลิตภัณฑ์: Places SDK สำหรับ Android
- หรือที่เรียกว่า Places SDK สำหรับ Android (ใหม่)
- หมวดหมู่: สถานที่
- แพลตฟอร์ม: Android
- ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
- ระยะการเปิดตัว: GA
- วงจร: ใช้งานอยู่
- ภาพรวม: ภาพรวมของ Places SDK สำหรับ Android
Places SDK สำหรับ Android: กรณีที่ควรใช้
ใช้ Places SDK สำหรับ Android ในกรณีต่อไปนี้
- คุณต้องการรายละเอียดสถานที่ รูปภาพ ผลการค้นหาในบริเวณใกล้เคียง หรือผลการค้นหาข้อความภายในแอป Android แบบเนทีฟ
- คุณต้องมีวิดเจ็ตการเติมข้อความอัตโนมัติสำเร็จรูปหรือคอมโพเนนต์ Places UI Kit ที่แสดงการคาดคะเนสถานที่ขณะที่ผู้ใช้พิมพ์ในแอป Android
- คุณต้องสร้างฟีเจอร์ Android ที่รับรู้ถึงตำแหน่งโดยอิงตามธุรกิจและจุดที่น่าสนใจใกล้กับอุปกรณ์ของผู้ใช้
อย่าใช้ Places SDK สำหรับ Android ในกรณีต่อไปนี้
- คุณต้องเรียกใช้ Places จากเซิร์ฟเวอร์หรือแบ็กเอนด์ผ่าน HTTP แทนที่จะเรียกใช้จากแอป Android โดยใช้ Places API (ใหม่) แทน
- คุณกำลังสร้างแอป iOS แบบเนทีฟ ให้ใช้ Places SDK สำหรับ iOS แทน
- คุณกำลังสร้างหน้าเว็บในเบราว์เซอร์ โปรดใช้ Maps JavaScript API แทน
Places SDK สำหรับ Android: การตั้งค่า
- บริการที่ต้องเปิดใช้:
places.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- การระบุแหล่งที่มาของการใช้งาน: เรียกใช้
Places.addInternalUsageAttributionId(String)เมื่อเริ่มต้น SDK เพื่อส่งรหัสการระบุแหล่งที่มาของการใช้งาน ลบการเรียกใช้หรือส่งสตริงว่างเพื่อเลือกไม่ใช้ - เริ่มต้นใช้งาน: ตั้งค่า Places SDK สำหรับ Android
- ข้อมูลอ้างอิง: ข้อมูลอ้างอิง Places SDK สำหรับ Android
- ราคา: การใช้งานและการเรียกเก็บเงินของ Places SDK สำหรับ Android
- นโยบาย: นโยบาย Places SDK สำหรับ Android
- บันทึกประจำรุ่น: บันทึกประจำรุ่นของ Places SDK สำหรับ Android
แพ็กเกจ Places SDK สำหรับ Android อย่างเป็นทางการ
- maven:
com.google.android.libraries.places:places
Places SDK สำหรับ Android: สินค้าที่เกี่ยวข้อง
- มักใช้ร่วมกับ: Maps SDK สำหรับ Android
Places SDK สำหรับ Android: ข้อผิดพลาดที่พบบ่อย
- ปัญหา: คำขอการค้นหาในบริเวณใกล้เคียงที่ไม่มีรายการช่อง (มาสก์ช่อง) หรือมีรายการช่องว่างเปล่าจะแสดงข้อผิดพลาด วิธีแก้ไข: ส่ง
Place.Fieldอย่างน้อย 1 รายการในรายการช่องSearchNearbyRequestดู /maps/documentation/places/android-sdk/nearby-search - ปัญหา: รายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการเติมข้อความอัตโนมัติ (ใหม่) จะไม่สำเร็จเมื่อคีย์ API ไม่มี Places API (ใหม่) หรือใน SDK 5.x และเวอร์ชันก่อนหน้าเมื่อแอปเรียกใช้
Places.initialize()เวอร์ชัน 6.0.2 นำPlaces.initialize()ออก ดังนั้นโค้ดที่เรียกใช้จึงไม่คอมไพล์หลังจากอัปเกรด วิธีแก้ไข: เปิดใช้ Places API (ใหม่) เพิ่มลงใน API ที่อนุญาตของคีย์ API และเริ่มต้นด้วยPlaces.initializeWithNewPlacesApiEnabled()ดู /maps/documentation/places/android-sdk/legacy/migrate-overview - ปัญหา:
Placeที่fetchPlace()แสดงผลไม่มีPhotoMetadata(จึงไม่มีอะไรให้แก้ไข) เมื่อรายการช่องละเว้นPHOTO_METADATASวิธีแก้ไข: ใส่Place.Field.PHOTO_METADATASในรายการช่อง เนื่องจากfetchResolvedPhotoUri()เลิกใช้งานแล้ว ให้ใช้คอมโพเนนต์รายละเอียดสถานที่ของ Places UI Kit เพื่อแสดงรูปภาพ ดู /maps/documentation/places/android-sdk/place-photos - ปัญหา: แอปที่แสดงรายละเอียดสถานที่ รูปภาพ หรือรีวิวโดยไม่มีการระบุแหล่งที่มาของบุคคลที่สามและผู้เขียนที่แสดงผลจะละเมิดนโยบาย วิธีแก้ไข: แสดงการระบุแหล่งที่มาที่แสดงผลพร้อมกับออบเจ็กต์
Place,PhotoMetadataและReviewดู /maps/documentation/places/android-sdk/policies
Places SDK สำหรับ Android: ฟีเจอร์เดิมและฟีเจอร์ที่เลิกใช้งานแล้ว
- ฟีเจอร์ Places SDK for Android (เดิม) / Places API (เดิม) (การเติมข้อความอัตโนมัติ, สถานที่ปัจจุบัน, รายละเอียดสถานที่, รูปภาพสถานที่เดิม): เดิม ตั้งแต่วันที่ 1 มีนาคม 2025 รายการทดแทน: ฟีเจอร์ Places SDK สำหรับ Android (ใหม่) ที่สนับสนุนโดย Places API (ใหม่) ซึ่งเริ่มต้นด้วย
Places.initializeWithNewPlacesApiEnabled()ลักษณะปัญหา: ตั้งแต่เดือนตุลาคม 2026 เป็นต้นไป โปรเจ็กต์ที่อยู่ในระบบคลาวด์ใหม่จะไม่สามารถเปิดใช้ Places API (เดิม) ได้ (โปรเจ็กต์ที่มีอยู่จะยังคงได้รับการสนับสนุน) SDK 6.0.2 นำเมธอดเดิมออก ซึ่งมีอยู่ใน 5.x และเวอร์ชันก่อนหน้าเท่านั้น ดูคำแนะนำในการย้ายข้อมูล Places.initialize(): เลิกใช้งานตั้งแต่วันที่ 30-09-2026 การเปลี่ยนทดแทน:Places.initializeWithNewPlacesApiEnabled()อาการ: นำเมธอดออกจาก SDK ในเวอร์ชัน 6.0.2 โค้ดที่เรียกใช้เมธอดดังกล่าวจะไม่คอมไพล์อีกต่อไป ดูคำแนะนำในการย้ายข้อมูลPlacesClient.findCurrentPlace()และawaitFindCurrentPlace()(สถานที่ปัจจุบัน, เดิม): เลิกใช้งานตั้งแต่วันที่ 30 กันยายน 2026 รายการทดแทน:PlacesClient.searchNearby()(การค้นหาในบริเวณใกล้เคียง (ใหม่)) อาการ: เมธอดและคลาสFindCurrentPlaceRequest/FindCurrentPlaceResponseถูกนำออกในเวอร์ชัน 6.0.2 ดูคำแนะนำในการย้ายข้อมูลPlacesClient.fetchPhoto()และawaitFetchPhoto(): เลิกใช้งานตั้งแต่วันที่ 30-09-2026 รายการทดแทน: คอมโพเนนต์รายละเอียดสถานที่ของ Places UI Kit (PlacesClient.fetchResolvedPhotoUri()เลิกใช้งานแล้ว) อาการ: เมธอดและคลาสFetchPhotoRequest/FetchPhotoResponseถูกนำออกในเวอร์ชัน 6.0.2 ดูคำแนะนำในการย้ายข้อมูล- วิดเจ็ตเติมข้อความอัตโนมัติของ Places API (เดิม) (
Autocomplete,AutocompleteSupportFragment,AutocompleteActivityMode): เลิกใช้งานตั้งแต่วันที่ 30-09-2026 การแทนที่: วิดเจ็ต Place Autocomplete (ใหม่) (PlaceAutocomplete) หรือPlacesClient.findAutocompletePredictions()อาการ: คลาสถูกนำออกจาก SDK ในเวอร์ชัน 6.0.2 ดูคำแนะนำในการย้ายข้อมูล - ไลบรารีความเข้ากันได้ของ Places (
com.google.android.libraries.places:places-compat): เลิกใช้งานตั้งแต่วันที่ 31-03-2022 รายการทดแทน: Places SDK สำหรับ Android (com.google.android.libraries.places:places) อาการ: หยุดอยู่ที่เวอร์ชัน 2.6.0 ไม่มีฟีเจอร์ใหม่หรือการแก้ไขข้อบกพร่อง - คลาส
AutocompleteFragment: เลิกใช้งานตั้งแต่วันที่ 25-09-2025 รายการทดแทน: วิดเจ็ต Place Autocomplete (ใหม่) (PlaceAutocomplete) ลักษณะปัญหา: ระบบนำคลาสออกจาก SDK ในเวอร์ชัน 5.0.0 (AutocompleteSupportFragmentถูกนำออกในเวอร์ชัน 6.0.2 ด้วย)
สิ่งที่คุณทำได้ด้วย Places SDK สำหรับ Android
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ
Places SDK สำหรับ Android: Generative AI
- แสดงข้อมูลสรุปที่ทำงานด้วยระบบ AI ของรีวิวจากผู้ใช้สำหรับตัวระบุ Google Place ที่ระบุ
- แสดงข้อมูลสรุปเกี่ยวกับสถานที่ซึ่งทำงานด้วยระบบ AI ของพื้นที่และสิ่งอำนวยความสะดวกรอบๆ ตัวระบุ Google Places ที่ระบุสำหรับสถานีชาร์จรถยนต์ไฟฟ้า
Places SDK สำหรับ Android: 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 สำหรับสถานที่หนึ่งๆ
- แสดงข้อมูลเกี่ยวกับสถานที่ที่อุปกรณ์ของผู้ใช้อยู่ในปัจจุบัน หมายเหตุ: ระบบได้นำเมธอด Current Place เดิมออกใน Places SDK สำหรับ Android เวอร์ชัน 6.0 ขึ้นไปและ Places SDK สำหรับ iOS เวอร์ชัน 11.0 ขึ้นไป โปรดดึงข้อมูลพิกัดของอุปกรณ์จากบริการตำแหน่งของแพลตฟอร์มและเรียกใช้การค้นหาในบริเวณใกล้เคียง
- แสดงข้อมูลสรุปภาพรวมโดย AI สำหรับสถานที่ที่เฉพาะเจาะจง
- แสดงข้อมูลสรุปเกี่ยวกับพื้นที่ที่ทำงานด้วยระบบ AI ซึ่งอธิบายสถานที่ในพื้นที่รอบๆ สถานที่หนึ่งๆ
- แสดงข้อมูลเกี่ยวกับสถานที่ตามสตริงการค้นหาที่อยู่ตามเส้นทางที่กำหนดไว้ล่วงหน้า
- แสดงระยะทาง ระยะเวลาเดินทาง และ URI เส้นทางไปยังสถานที่ที่ค้นหาด้วยข้อความจากชุดพิกัดละติจูด/ลองจิจูด
- แสดงระยะทาง ระยะเวลาเดินทาง และ URI เส้นทางไปยังสถานที่ใกล้เคียงจากชุดพิกัดละติจูด/ลองจิจูด
- แสดงผลระยะทาง ระยะเวลาเดินทาง และ URI ของเส้นทางระหว่างจุดเริ่มต้นของเส้นทางที่กำหนดไว้ล่วงหน้ากับสถานที่แต่ละแห่งที่แสดงผลตามสตริงการค้นหา ซึ่งอยู่ตามเส้นทางด้วย
- แสดงผลระยะทาง ระยะเวลาเดินทาง และ URI ของเส้นทางระหว่างสถานที่แต่ละแห่งที่แสดงผลตามสตริงการค้นหา ซึ่งอยู่ตามเส้นทางที่กำหนดไว้ล่วงหน้าและจุดหมายของเส้นทางด้วย
Places SDK สำหรับ Android: Places UI Kit
- ใช้การจัดรูปแบบ CSS กับองค์ประกอบ UI ของข้อมูลสถานที่ หมายเหตุ: พร็อพเพอร์ตี้ที่กำหนดเองของ CSS จะใช้กับองค์ประกอบ Places UI Kit ของ Maps JavaScript API ส่วน Places SDK สำหรับ Android และ Places SDK สำหรับ iOS จะจัดรูปแบบมุมมอง Places UI Kit แบบเป็นโปรแกรมโดยใช้แอตทริบิวต์ธีมและสไตล์ ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
- ปรับแต่งการจัดรูปแบบและการกำหนดค่าองค์ประกอบ UI ของข้อมูลสถานที่ด้วยเครื่องมือปรับแต่งองค์ประกอบ UI หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
- เพิ่มองค์ประกอบ UI ที่แสดงข้อมูลเกี่ยวกับสถานที่หนึ่งๆ ลงในหน้าเว็บหรือแอปบนอุปกรณ์เคลื่อนที่ หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: หากต้องการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
- เพิ่มองค์ประกอบ UI ที่แสดงรายการสถานที่ตามสตริงการค้นหาลงในหน้าเว็บ หมายเหตุ: รองรับทั้งในหน้าเว็บ (Maps JavaScript API) และแอปบนอุปกรณ์เคลื่อนที่ (Places SDK สำหรับ Android และ Places SDK สำหรับ iOS) ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
- เพิ่มองค์ประกอบ UI ที่แสดงรายการสถานที่ใกล้กับตำแหน่งที่เฉพาะเจาะจงลงในหน้าเว็บ หมายเหตุ: รองรับทั้งในหน้าเว็บ (Maps JavaScript API) และแอปบนอุปกรณ์เคลื่อนที่ (Places SDK สำหรับ Android และ Places SDK สำหรับ iOS) ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq
- เพิ่มองค์ประกอบ UI การเติมข้อความอัตโนมัติพื้นฐานลงในหน้าเว็บหรือแอปที่แสดงตัวระบุ Google Place ตามสตริงการค้นหา หมายเหตุ: ข้อกำหนดด้านการปฏิบัติตามข้อกำหนดของ EEA: สำหรับการแสดงข้อมูลสถานที่บนแผนที่ในเขตเศรษฐกิจยุโรป (EEA) โปรดอย่าเรียกใช้เว็บเซอร์วิสของ Places API จากเซิร์ฟเวอร์แบ็กเอนด์ ใช้คอมโพเนนต์ Places UI Kit ฝั่งไคลเอ็นต์ในแพลตฟอร์มเป้าหมาย (Maps JavaScript API บนเว็บ, Places SDK สำหรับ Android บน Android หรือ Places SDK สำหรับ iOS บน iOS) ดูข้อกำหนดทั้งหมดและคำถามที่พบบ่อยได้ที่ https://developers.google.com/maps/comms/eea/faq