ข้อมูลอ้างอิงด่วนของ Places SDK สำหรับ Android

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 SDK สำหรับ Android อย่างเป็นทางการ

  • maven: com.google.android.libraries.places:places

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

Places SDK สำหรับ Android: Places

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