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 ก่อน ดูข้อมูลเพิ่มเติมได้ที่ตั้งค่าโปรเจ็กต์ 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
- ย้ายข้อมูลไปยังรายละเอียดสถานที่ (ใหม่)
- ย้ายข้อมูลไปยัง Place Photos (ใหม่)
- ย้ายข้อมูลไปยังการเติมข้อความอัตโนมัติ (ใหม่)