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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ใช้ Places Swift SDK สำหรับ iOS (เวอร์ชันตัวอย่าง)

คุณต้องทําตามขั้นตอนต่อไปนี้เพื่อใช้ Places Swift SDK สําหรับ iOS (เวอร์ชันตัวอย่าง)

  1. เปิดใช้ Places API (ใหม่)
  2. เพิ่ม Places Swift SDK สําหรับ iOS (เวอร์ชันตัวอย่าง) ลงในรายการที่ต้องพึ่งพา
  3. เริ่มต้นใช้งานไคลเอ็นต์ Places ด้วย PlacesClient

ดูข้อมูลเพิ่มเติมเกี่ยวกับ Places Swift SDK สําหรับ iOS (เวอร์ชันตัวอย่าง) ได้ที่ภาพรวมหรือคําแนะนําในการย้ายข้อมูล

ย้ายข้อมูลไปยัง 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 และ Text Search คุณจะใช้รายการช่องเพื่อควบคุมรายการช่องที่จะแสดงในการตอบกลับ จากนั้นระบบจะเรียกเก็บเงินจากคุณเฉพาะสำหรับข้อมูลที่ขอเท่านั้น การใช้รายการช่องเป็นแนวทางปฏิบัติด้านการออกแบบที่ดีเพื่อให้มั่นใจว่าคุณจะไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและค่าบริการเรียกเก็บเงินที่ไม่จำเป็น

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