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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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 การเข้าพักในฟาร์ม 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
ที่ปรึกษา ลานเฮลิคอปเตอร์ playground 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 hotel rest_stop

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

  • country
  • administrative_area_level_1
  • administrative_area_level_2
  • postal_code
  • locality