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

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

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

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

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

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

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

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

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

  1. ในโปรเจ็กต์ Google Cloud ให้เปิดใช้ Places API, Places API (ใหม่) หรือ ทั้ง 2 อย่าง สำหรับข้อมูลเพิ่มเติม โปรดดูที่เปิดใช้งาน API
  2. ในข้อจำกัดของคีย์ API ให้เปิดใช้ Places API, Places API (ใหม่) หรือ ทั้ง 2 อย่าง ดูข้อมูลเพิ่มเติมได้ที่การจำกัด API
  3. ระบุหมายเลขเวอร์ชันในไฟล์ create.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
เติมข้อความอัตโนมัติเกี่ยวกับสถานที่ Places API initialize()
สถานที่ปัจจุบัน Places API initialize()
รายละเอียดสถานที่ Places API initialize()
รูปภาพสถานที่ Places API initialize()

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

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

  • หากคุณเป็นลูกค้าใหม่ที่เพิ่งเริ่มต้นใช้งาน Places SDK สำหรับ Android จากนั้นให้เริ่มต้นด้วย Places API (ใหม่) และ SDK ใหม่
  • หากเป็นลูกค้าเดิม คุณจะใช้ SDK ที่มีอยู่ต่อไปได้ แต่หากต้องการใช้ประโยชน์จากการปรับปรุงประสิทธิภาพและฟีเจอร์ การปรับปรุง Places SDK สำหรับ Android (ใหม่) คุณควรใช้ SDK ไม่จำเป็นต้องย้ายข้อมูลเมื่อย้ายไปใช้ SDK ใหม่ เพียงแค่ทำตาม ขั้นตอนในเลือกเวอร์ชัน SDK และ API บริการ
  • ใน Places SDK สำหรับ Android (ใหม่) โทเค็นเซสชันจะพร้อมใช้งานตั้งแต่ ในเวอร์ชัน 3.5.0 สำหรับข้อมูลเพิ่มเติม โปรดดู เซสชัน โทเค็น
  • การโทรที่ใช้วิดเจ็ตเติมตำแหน่งอัตโนมัติจะโทรสถานที่เสมอ เติมข้อความอัตโนมัติ ไม่ใช่ เติมข้อความอัตโนมัติในสถานที่ (ใหม่); การเรียกวิดเจ็ตจะไม่ได้รับผลกระทบจาก วิธีการเริ่มต้น
  • รูปภาพสถานที่ (ใหม่) แสดงผล 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" บริการตอบสนองด้วยรายการ ของตำแหน่งที่ตรงกับสตริงข้อความและความเอนเอียงของตำแหน่งที่ตั้งไว้

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

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

ตอนนี้คุณใช้ รูปภาพสถานที่ (ใหม่) เพื่อแสดง URI ไปยังบิตแมปรูปภาพ ก่อนหน้านี้ คุณสามารถส่งคืนเฉพาะ บิตแมปรูปภาพนั้น

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

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

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

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

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

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

ประเภท
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 Farmstay 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