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

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

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

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

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

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

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

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

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

  1. ในโปรเจ็กต์ Google Cloud ให้เปิดใช้ Places API, Places API (ใหม่) หรือ ทั้ง 2 อย่าง สำหรับข้อมูลเพิ่มเติม โปรดดูที่เปิดใช้งาน API
  2. ในข้อจำกัดของคีย์ API ให้เปิดใช้ Places API, Places API (ใหม่) หรือ ทั้ง 2 อย่าง ดูข้อมูลเพิ่มเติมได้ที่การจำกัด API คีย์
  3. เมื่อติดตั้ง SDK ให้ระบุหมายเลขเวอร์ชัน สำหรับข้อมูลเพิ่มเติม ดู Set an Xcode project

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

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

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

ฟีเจอร์ เปิดใช้ Places API ในคีย์ API เวอร์ชัน SDK ขั้นต่ำ
เติมข้อความอัตโนมัติ (ใหม่) Places API (ใหม่) 9.0.0
รายละเอียดสถานที่ (ใหม่) Places API (ใหม่) 9.0.0
การค้นหาใกล้เคียง (ใหม่) Places API (ใหม่) 9.0.0
รูปภาพสถานที่ (ใหม่) Places API (ใหม่) 9.0.0
การค้นหาข้อความ (ใหม่) Places API (ใหม่) 8.5.0
เติมข้อความอัตโนมัติเกี่ยวกับสถานที่ Places API 3.0.0
สถานที่ปัจจุบัน Places API 3.0.0
รายละเอียดสถานที่ Places API 3.0.0
รูปภาพสถานที่ Places API 3.0.0

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

  • หากคุณเป็นลูกค้าใหม่ที่เพิ่งเริ่มต้นใช้งาน Places SDK สำหรับ iOS เริ่มต้นด้วย Places API (ใหม่) และ SDK ใหม่
  • หากเป็นลูกค้าเดิม คุณจะใช้ SDK ที่มีอยู่ต่อไปได้ แต่หากต้องการใช้ประโยชน์จากการปรับปรุงประสิทธิภาพและฟีเจอร์ การปรับปรุง Places SDK สำหรับ iOS (ใหม่) คุณควรเปิดใช้ Places API (ใหม่) และใช้ SDK ใหม่ ไม่จำเป็นต้องย้ายข้อมูลเมื่อย้ายไปยัง SDK ใหม่ เพียงทำตามขั้นตอนในเลือกเวอร์ชัน SDK และ API ของคุณ บริการ
  • Places API (ใหม่) ไม่ได้เปิดใช้งานบางรายการที่มีอยู่ คุณลักษณะเช่น ปัจจุบัน สถานที่ GMSPlace.isOpen และ GMSPlaceisOpenAtDate

ใช้รุ่นตัวอย่างจาก GooglePlacesSwift

การใช้ GooglePlaceswift มีขั้นตอนดังนี้

  1. เปิดใช้ Places API (ใหม่)
  2. เพิ่ม GooglePlacesSwiftSDK ทรัพยากร Dependency ของคุณ
  3. เริ่มต้นไคลเอ็นต์ Places ด้วย PlacesClient

หากต้องการดูข้อมูลเพิ่มเติมเกี่ยวกับ GooglePlacesSwift โปรดอ่านข้อมูลอ้างอิง เอกสารประกอบ

ย้ายข้อมูลไปยัง API ใหม่

หากคุณใช้ API ที่มีอยู่และต้องการย้ายข้อมูลไปยัง API ใหม่ โปรดดูที่ คำแนะนำการย้ายข้อมูลต่อไปนี้สำหรับ API แต่ละรายการ

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

ส่วนนี้ครอบคลุมคุณลักษณะสำคัญที่เพิ่มลงใน Places SDK สำหรับ iOS (ใหม่)

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

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

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

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

ฟีเจอร์ใหม่

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

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

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

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

สำหรับข้อมูลการกำหนดราคาโดยละเอียดสำหรับ 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