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