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 ที่พร้อมใช้งานในแอป ให้ทำดังนี้
- ในโปรเจ็กต์ Google Cloud ให้เปิดใช้ Places API, Places API (ใหม่) หรือ ทั้ง 2 อย่าง โปรดดูข้อมูลเพิ่มเติมที่เปิดใช้งาน API
- ในข้อจำกัดของคีย์ API ให้เปิดใช้ Places API, Places API (ใหม่) หรือ ทั้ง 2 อย่าง ดูข้อมูลเพิ่มเติมได้ที่การจำกัด API คีย์
- เมื่อติดตั้ง 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 มีขั้นตอนดังนี้
- เปิดใช้ Places API (ใหม่)
- เพิ่ม GooglePlacesSwiftSDK ทรัพยากร Dependency ของคุณ
- เริ่มต้นไคลเอ็นต์ 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