Places SDK สำหรับ iOS (ใหม่) มีประสิทธิภาพที่ดีขึ้นและ รูปแบบการกำหนดราคาใหม่ จึงคุ้มค่าที่จะอัปเดตแอปที่ใช้ Places SDK สำหรับ iOS (เดิม) ดูรายละเอียดเพิ่มเติมเกี่ยวกับการเปรียบเทียบฟีเจอร์ได้ที่หัวข้อ เลือก SDK
ใช้คู่มือนี้เพื่อทำความเข้าใจความแตกต่างที่สำคัญใน Places SDK สำหรับ iOS (ใหม่) เมื่อเทียบกับ Places SDK สำหรับ iOS (เดิม) รวมถึงวิธี จัดการการเปลี่ยนแปลงที่จำเป็น
แนวทางปฏิบัติแนะนำในการเรียกเก็บเงินสำหรับการย้ายข้อมูล
คำแนะนำนี้จะมีผลหากการใช้งาน API ของคุณสูงพอที่จะเปลี่ยนไปใช้การกำหนดราคาระดับที่ 2 เมื่อย้ายข้อมูลไปยัง API เวอร์ชันใหม่กว่า ระบบจะเรียกเก็บเงินจากคุณสำหรับ SKU อื่นด้วย เพื่อหลีกเลี่ยงค่าใช้จ่ายที่เพิ่มขึ้นในเดือนที่เปลี่ยนผ่าน เราขอแนะนำให้เปลี่ยนไปใช้ API ใหม่ในเวอร์ชันที่ใช้งานจริงให้ใกล้เคียงกับต้นเดือนมากที่สุด ซึ่งจะช่วยให้คุณเข้าถึงระดับราคาต่อเดือนที่คุ้มค่าที่สุด ในเดือนที่ทำการย้ายข้อมูล ดูข้อมูลเกี่ยวกับระดับราคาได้ที่หน้าการกำหนดราคา และคำถามที่พบบ่อยเกี่ยวกับการกำหนดราคา
ข้อผิดพลาด: kGMSPlacesRateLimitExceeded
Places API (ใหม่)
Places SDK สำหรับ iOS ใช้บริการ Places API หากต้องการใช้ฟีเจอร์ของ Places SDK สำหรับ iOS (ใหม่) คุณต้องเปิดใช้ Places API (ใหม่) ในโปรเจ็กต์ Google Cloud ก่อน ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าโปรเจ็กต์ Google Cloud
จากนั้นคุณต้องยืนยันว่าได้เพิ่ม Places SDK สำหรับ iOS (ใหม่) ลงในรายการ API ที่ได้รับอนุญาตในคีย์ที่แอปใช้แล้ว ดูข้อมูลเพิ่มเติมได้ที่ใช้คีย์ API
ตรวจสอบว่าคุณมีโควต้าเพียงพอใน Places API (ใหม่)
ตรวจสอบว่ามีโควต้าเพียงพอใน Places SDK สำหรับ iOS (ใหม่) เพื่อรองรับการเข้าชมปัจจุบันใน Places SDK สำหรับ iOS (เดิม) หากต้องการตรวจสอบและ จัดการโควต้าและขีดจำกัดการใช้งาน โปรดดูโควต้าและการแจ้งเตือน เกี่ยวกับโควต้า โปรดทราบถึงความแตกต่าง ระหว่าง API ทั้ง 2 รายการ
- โควต้าสำหรับ Places SDK สำหรับ iOS (เดิม) ขึ้นอยู่กับโควต้าของบริการ Places API (เดิม) ซึ่งเป็นผลรวมของเมธอด Places API ทั้งหมด
- โควต้าสำหรับ Places SDK สำหรับ iOS (ใหม่) ขึ้นอยู่กับโควต้าของบริการ Places API (ใหม่) โดยจะมีโควต้าแยกต่างหากสำหรับเมธอด API แต่ละรายการ
ตรวจสอบว่าข้อตกลงที่เจรจาไว้มี Places API (ใหม่) หรือไม่
หากคุณมีข้อตกลงที่เจรจาต่อรองไว้ ให้ตรวจสอบว่าข้อตกลงดังกล่าวครอบคลุม Places API (ใหม่) โดยมีราคาตามที่คาดไว้ หากไม่ โปรดติดต่อผู้ติดต่อฝ่ายขายที่ Google หรือพาร์ทเนอร์เพื่อพูดคุยเกี่ยวกับวิธีรวม API นี้
การเปลี่ยนแปลงทั่วไป
การเปลี่ยนแปลงทั่วไปบางอย่างที่ใช้กับ API หลายรายการมีดังนี้
ใช้รูปแบบการกำหนดราคาใหม่ ดูข้อมูลราคาสำหรับ API ทั้งหมดได้ที่ราคา สำหรับ Places SDK สำหรับ iOS (ใหม่)
รายละเอียดสถานที่ (ใหม่) การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ต้องใช้มาสก์ฟิลด์ เพื่อระบุฟิลด์ที่คุณต้องการให้แสดงผลในการตอบกลับ
GMSPlacesClientมีเมธอดใหม่ๆ สำหรับเรียกใช้ API ใหม่เหล่านี้เราได้เพิ่มคลาสใหม่เพื่อกำหนดคำขอไปยัง API ใหม่แต่ละรายการ
อินสแตนซ์การตอบกลับ
GMSPlaceมีพร็อพเพอร์ตี้reviewsใหม่ของประเภทGMSPlaceReviewเมื่อแอปแสดงข้อมูลที่ได้จากอินสแตนซ์GMSPlaceเช่น รูปภาพและรีวิว แอปจะต้องแสดงการระบุแหล่งที่มาที่จำเป็นด้วยดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบเกี่ยวกับการระบุแหล่งที่มา
การเปลี่ยนแปลงเฉพาะ API
ส่วนนี้ประกอบด้วยคำแนะนำในการย้ายข้อมูลต่อไปนี้สำหรับ API แต่ละรายการ
- ย้ายข้อมูลไปยังรายละเอียดสถานที่ (ใหม่)
- ย้ายข้อมูลไปยังรูปภาพสถานที่ (ใหม่)
- ย้ายข้อมูลไปยัง Autocomplete (ใหม่)