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