เลือกเวอร์ชัน SDK ของคุณ

ฟีเจอร์ของ Places SDK สําหรับ Android ที่มีให้ใช้งานในแอปจะขึ้นอยู่กับหมายเลขเวอร์ชัน SDK (เช่น 3.5.0) ที่คุณระบุในการกําหนดค่าแอป, API ที่เปิดใช้ในคีย์ API และวิธีเริ่มต้นแอป คู่มือนี้จะอธิบายความแตกต่างระหว่างเวอร์ชันต่างๆ และวิธีเลือกเวอร์ชันที่จะเปิดใช้ในแอป

หมายเลขเวอร์ชัน SDK

หมายเลขเวอร์ชันของ SDK ที่คุณระบุไว้ในไฟล์ build.gradle ระดับแอปจะเป็นตัวกำหนดว่าแอปของคุณมีสิทธิ์เข้าถึงฟีเจอร์ที่เพิ่มเข้ามาในรุ่นใดรุ่นหนึ่งหรือไม่ ตัวอย่างเช่น ฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) มีให้บริการใน SDK เวอร์ชัน 3.5.0 ขึ้นไปเท่านั้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปลี่ยนแปลงที่นำมาใช้ใน SDK แต่ละเวอร์ชันได้ที่หมายเหตุเกี่ยวกับรุ่น SDK ของ Google สถานที่สำหรับ Android

เวอร์ชัน Places API สำหรับ Places SDK สำหรับ Android

นอกจากการระบุหมายเลขเวอร์ชัน SDK แล้ว คุณยังต้องเลือกบริการ Places API ที่ SDK เรียกใช้ในคอนโซล Google Cloud ด้วย ซึ่งได้แก่ Places API หรือ Places API (ใหม่) บริการ API ที่คุณเลือกจะกำหนดเวอร์ชันของฟีเจอร์ที่พร้อมใช้งานในแอป เช่น ฟีเจอร์เติมข้อความอัตโนมัติหรือฟีเจอร์เติมข้อความอัตโนมัติ (ใหม่) ร่วมกับหมายเลขเวอร์ชัน SDK แม้ว่าคุณจะระบุหมายเลขเวอร์ชัน SDK ได้เพียงหมายเลขเดียว แต่ก็สามารถเปิดใช้ทั้ง Places API และ Places API (ใหม่) ในคีย์ API ได้พร้อมกัน จากนั้นเลือกบริการที่ SDK จะเรียกผ่านเมธอดที่คุณใช้เพื่อเริ่มต้นใช้งาน SDK ในแอป อย่างไรก็ตาม ในกรณีส่วนใหญ่ คุณจะต้องเปิดใช้ Places API (ใหม่) และใช้ฟีเจอร์ SDK เวอร์ชัน (ใหม่) ในแอป

เลือกเวอร์ชัน SDK และบริการ API

หากต้องการเลือกฟีเจอร์ SDK ที่พร้อมใช้งานในแอป ให้ทําดังนี้

  1. เปิดใช้ Places API, Places API (ใหม่) หรือทั้ง 2 อย่างในโปรเจ็กต์ Google Cloud ดูข้อมูลเพิ่มเติมได้ที่เปิดใช้ API
  2. ในข้อจำกัดของคีย์ API ให้เปิดใช้ Places API, Places API (ใหม่) หรือทั้ง 2 อย่าง ดูข้อมูลเพิ่มเติมได้ที่การจํากัดคีย์ API

  3. ระบุหมายเลขเวอร์ชันในไฟล์ build.gradle ระดับแอป ดูข้อมูลเพิ่มเติมได้ที่การติดตั้ง

  4. เริ่มต้นแอปโดยเรียกใช้เมธอด Places.initializeWithNewPlacesApiEnabled() หรือ Places.initialize()

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเลือกบริการ Places API ได้ที่ตั้งค่าโปรเจ็กต์ Google Cloud

ฟีเจอร์ SDK ที่พร้อมใช้งานในแต่ละเวอร์ชัน

ตารางต่อไปนี้แสดงเวอร์ชัน SDK และ API ที่จําเป็นสําหรับฟีเจอร์ SDK แต่ละรายการ

ฟีเจอร์ เปิดใช้ Places API ในคีย์ API แล้ว วิธีการเริ่มต้น เวอร์ชัน SDK ขั้นต่ำ
เติมข้อความอัตโนมัติ (ใหม่) Places API (ใหม่) initializeWithNewPlacesApiEnabled() 3.5.0
รายละเอียดสถานที่ (ใหม่) Places API (ใหม่) initializeWithNewPlacesApiEnabled() 3.3.0
การค้นหาในบริเวณใกล้เคียง (ใหม่) Places API (ใหม่) initializeWithNewPlacesApiEnabled() 3.5.0
วางรูปภาพ (ใหม่) Places API (ใหม่) initializeWithNewPlacesApiEnabled() 3.4.0
การค้นหาข้อความ (ใหม่) Places API (ใหม่) initializeWithNewPlacesApiEnabled() 3.3.0
Place Autocomplete Places API initialize()
สถานที่ปัจจุบัน Places API initialize()
รายละเอียดสถานที่ Places API initialize()
Place Photos Places API initialize()

ข้อควรพิจารณาในการเลือกเวอร์ชันที่จะเปิดใช้

โปรดพิจารณาสิ่งต่อไปนี้เพื่อช่วยเลือกเวอร์ชัน

  • หากคุณเป็นลูกค้าใหม่เพิ่งเริ่มต้นใช้งาน Places SDK สําหรับ Android ให้เริ่มต้นด้วย Places API (ใหม่) และ SDK ใหม่
  • หากเป็นลูกค้าเดิม คุณจะใช้ SDK ที่มีอยู่ต่อไปได้ อย่างไรก็ตาม คุณควรใช้ SDK เวอร์ชันใหม่เพื่อใช้ประโยชน์จากการปรับปรุงประสิทธิภาพและการปรับปรุงฟีเจอร์ของ Places SDK สําหรับ Android (เวอร์ชันใหม่) คุณไม่จำเป็นต้องย้ายข้อมูลเมื่อเปลี่ยนไปใช้ SDK ใหม่ เพียงทำตามขั้นตอนในเลือกเวอร์ชัน SDK และบริการ API
  • ใน Places SDK สําหรับ Android (เวอร์ชันใหม่) โทเค็นเซสชันจะใช้ได้ตั้งแต่เวอร์ชัน 3.5.0 เป็นต้นไป ดูข้อมูลเพิ่มเติมได้ที่โทเค็นเซสชัน
  • การเรียกใช้โดยใช้วิดเจ็ต Place Autocomplete จะเรียกใช้ Place Autocomplete เสมอ ไม่ใช่ Place Autocomplete (ใหม่) การเรียกใช้วิดเจ็ตจะไม่ได้รับผลกระทบจากวิธีการเริ่มต้น
  • Place Photos (ใหม่) จะแสดงเฉพาะ URI ไปยังรูปภาพบิตแมป ขณะที่ Place Photos จะแสดงเฉพาะรูปภาพบิตแมป
  • สถานที่ปัจจุบันมีให้บริการใน Places SDK สำหรับ Android เท่านั้น ไม่ใช่ Places SDK สำหรับ Android (ใหม่)

การเพิ่มประสิทธิภาพใน Places SDK สำหรับ Android (ใหม่)

ส่วนนี้จะกล่าวถึงฟีเจอร์หลักที่เพิ่มลงใน Places SDK สําหรับ Android (ใหม่)

ติดตั้งใช้งานบนแพลตฟอร์มมาตรฐานของ Google Cloud

Places SDK สำหรับ Android (เวอร์ชันใหม่) ติดตั้งใช้งานในโครงสร้างพื้นฐานบริการใน Google Cloud การติดตั้งใช้งานนี้จะช่วยให้แพลตฟอร์มมีความปลอดภัยและเชื่อถือได้มากขึ้น การออกแบบมาตรฐานนี้ช่วยเพิ่มความสอดคล้องกันของ SDK ต่างๆ ซึ่งจะปรับปรุงประสิทธิภาพการพัฒนาด้วย Places SDK สําหรับ Android (ใหม่)

ประสิทธิภาพที่เพิ่มขึ้น

Places SDK สำหรับ Android (เวอร์ชันใหม่) มีประสิทธิภาพที่ดีขึ้น จึงเหมาะที่จะนำไปแทนที่แอปที่ใช้ SDK ที่มีอยู่

ฟีเจอร์ใหม่

Places SDK สำหรับ Android (ใหม่) มีฟีเจอร์ SDK ทั้งหมดเวอร์ชันล่าสุด ดังนี้

บริการค้นหาข้อความแบบใหม่

การค้นหาข้อความ (ใหม่) จะแสดงข้อมูลเกี่ยวกับชุดสถานที่ตามสตริง เช่น "พิซซ่าในนิวยอร์ก" หรือ "ร้านรองเท้าใกล้กับออตตาวา" หรือ "123 Main Street" บริการจะแสดงรายการสถานที่ที่ตรงกับสตริงข้อความและค่ากำหนดตำแหน่งที่ตั้งที่ตั้งไว้

เพิ่มข้อมูลคำตอบใหม่ลงในรายละเอียดสถานที่ (ใหม่) และรูปภาพสถานที่ (ใหม่)

  • รายละเอียดสถานที่ (ใหม่) ตอนนี้มีคลาสรีวิวใหม่ในออบเจ็กต์ Place ของการตอบกลับ คลาส Place มีเมธอด getReviews() ใหม่เพื่อรองรับช่องนี้ เรียกใช้ getReviews() เพื่อแสดงรีวิวสูงสุด 5 รายการของสถานที่

  • วางรูปภาพ (ใหม่) จะเพิ่ม AuthorAttributions ไปยังคลาส PhotoMetadata AuthorAttributions มี List ของ AuthorAttribution ออบเจ็กต์

เพิ่มการตอบกลับ URI ใหม่ลงใน "รูปภาพสถานที่" (ใหม่)

ตอนนี้คุณใช้ Place Photo (ใหม่) เพื่อแสดงผล URI ไปยังบิตแมปรูปภาพได้แล้ว ก่อนหน้านี้ คุณทำได้เพียงแสดงผลบิตแมปรูปภาพเท่านั้น

ราคาที่เข้าใจง่าย

การกำหนดราคามีความเรียบง่ายขึ้นด้วย Places SDK สำหรับ Android (ใหม่) เพื่อให้คุณจ่ายเฉพาะค่าข้อมูลที่ใช้งาน ราคาที่เข้าใจง่ายจะใช้กับรายการช่อง หรือที่เรียกว่ามาสก์ฟิลด์

เมื่อใช้รายละเอียดสถานที่และการค้นหาข้อความ คุณจะใช้รายการช่องเพื่อควบคุมรายการช่องที่จะแสดงในการตอบกลับ จากนั้นระบบจะเรียกเก็บเงินจากคุณเฉพาะสำหรับข้อมูลที่ขอเท่านั้น การใช้รายการช่องเป็นแนวทางปฏิบัติด้านการออกแบบที่ดีเพื่อให้มั่นใจว่าคุณจะไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและค่าบริการเรียกเก็บเงินที่ไม่จำเป็น

ดูข้อมูลราคาโดยละเอียดสำหรับทั้ง 2 SDK ได้ที่การใช้งานและการเรียกเก็บเงิน

ประเภทสถานที่แบบขยาย

SDK ใหม่จะเพิ่มประเภทสถานที่ที่แสดงในตารางต่อไปนี้ ระบบจะแสดงประเภทเหล่านี้เป็นส่วนหนึ่งของรายละเอียดสถานที่และการตอบกลับการค้นหาข้อความ นอกจากนี้ คุณยังใช้ประเภทใหม่เหล่านี้และประเภทที่มีอยู่ในการค้นหาด้วย Text Search ได้ด้วย ประเภทใหม่จะรวมอยู่ในตาราง A

ประเภท
american_restaurant discount_store ice_cream_shop sandwich_shop
amusement_center dog_park indian_restaurant school_district
athletic_field electric_vehicle_charging_station indonesian_restaurant seafood_restaurant
auto_parts_store event_venue italian_restaurant ski_resort
banquet_hall extended_stay_hotel japanese_restaurant spanish_restaurant
barbecue_restaurant ฟาร์ม korean_restaurant sporting_goods_store
barber_shop ที่พักในฟาร์ม lebanese_restaurant sports_club
bed_and_breakfast fast_food_restaurant Marina sports_complex
brazilian_restaurant ferry_terminal ตลาด steak_house
breakfast_restaurant fitness_center medical_lab sushi_restaurant
brunch_restaurant french_restaurant mediterranean_restaurant swimming_pool
bus_stop gift_shop mexican_restaurant ปรับแต่ง
camping_cabin golf_course middle_eastern_restaurant telecommunications_service_provider
cell_phone_store greek_restaurant โมเต็ล thai_restaurant
child_care_agency grocery_store national_park transit_depot
chinese_restaurant guest_house park_and_ride truck_stop
coffee_shop hair_salon performing_arts_theater turkish_restaurant
community_center hamburger_restaurant pizza_restaurant vegan_restaurant
ที่ปรึกษา ลานเฮลิคอปเตอร์ สนามเด็กเล่น vegetarian_restaurant
convention_center hiking_area อนุบาล vietnamese_restaurant
บังกะโล historical_landmark private_guest_room visitor_center
courier_service home_improvement_store ramen_restaurant wedding_venue
cultural_center โรงแรมขนาดเล็ก resort_hotel ผู้ค้าส่ง
dental_clinic โรงแรม rest_stop

นอกจากประเภทใหม่เหล่านี้แล้ว Places API (ใหม่) ยังย้ายประเภทต่อไปนี้จากตารางที่ 2 ของ Places API ไปยังตาราง ก ของ Places API (ใหม่) ด้วย ซึ่งหมายความว่าตอนนี้คุณใช้ประเภทต่อไปนี้เป็นส่วนหนึ่งของการค้นหาได้

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality