การใช้งานและการเรียกเก็บเงินของ Places API

เกี่ยวกับฟิลด์มาสก์

สำหรับรายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ให้ใช้ส่วนหัว FieldMask ในคำขอ API เพื่อระบุรายการฟิลด์ที่จะแสดงผลในการตอบกลับ จากนั้นระบบจะเรียกเก็บเงินจากคุณใน SKU ที่สูงที่สุด ที่เกี่ยวข้องกับคำขอของคุณ ซึ่งหมายความว่าหากคุณเลือกฟิลด์ทั้งใน SKU ของ Essentials และ Pro ระบบจะเรียกเก็บเงินจากคุณตาม SKU ของ Pro

การใช้การมาสก์ฟิลด์เป็นแนวทางปฏิบัติในการออกแบบที่ดีเพื่อให้มั่นใจว่าคุณจะไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลและการเรียกเก็บเงินที่ไม่จำเป็น

เกี่ยวกับเซสชันการเติมข้อความอัตโนมัติ (ใหม่)

เซสชันการเติมข้อความอัตโนมัติ (ใหม่) มีคำขอการเติมข้อความอัตโนมัติ (ใหม่) อย่างน้อย 1 รายการ และคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอ Address Validation ระบบจะส่งโทเค็นของเซสชันเดียวกันไปยังคำขอเติมข้อความอัตโนมัติ (ใหม่) และคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอ Address Validation ที่ตามมา

เซสชันจะเริ่มต้นด้วยคำขอการเติมข้อความอัตโนมัติ (ใหม่) รายการแรก จากนั้นระบบจะส่งคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอ Address Validation เมื่อผู้ใช้เลือกคำแนะนำการเติมข้อความอัตโนมัติ (ใหม่) รายการใดรายการหนึ่ง หากเซสชันถูกละทิ้ง ซึ่งหมายความว่าไม่มีการส่งคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอ Address Validation ระบบจะเรียกเก็บเงินสำหรับคำขอเติมข้อความอัตโนมัติ (ใหม่) เสมือนว่าไม่มีการระบุโทเค็นของเซสชัน

หลังจากที่ผู้ใช้เลือกสถานที่แล้ว (หมายความว่ามีการส่งคำขอรายละเอียดสถานที่ (ใหม่) หรือคำขอ Address Validation) คุณต้องเริ่มเซสชันใหม่โดยใช้โทเค็นของเซสชันใหม่

โทเค็นของเซสชันใช้ได้กับเซสชันเดียวและใช้กับเซสชันมากกว่า 1 เซสชันไม่ได้ หากคุณใช้โทเค็นของเซสชันซ้ำ ระบบจะถือว่าเซสชันไม่ถูกต้องและจะเรียกเก็บเงินสำหรับคำขอเสมือนว่าไม่มีการระบุโทเค็นของเซสชัน

รายละเอียด SKU และราคาสำหรับ Places API

ตารางต่อไปนี้แสดงรายละเอียด SKU แบบจ่ายเมื่อใช้และราคาสำหรับ Places API

หมวดหมู่รายละเอียด SKU ของ Places API (ใหม่)ราคา SKU
Essentials SKU: คำขอเติมข้อความอัตโนมัติ รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: การใช้งานเซสชันการเติมข้อความอัตโนมัติ รายการราคาทั่วโลก
รายการราคาในอินเดีย
Essentials SKU: รายละเอียดสถานที่ Essentials (รหัสเท่านั้น) รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: Place Details Essentials รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: Search Essentials สำหรับการค้นหาข้อความ (รหัสเท่านั้น) รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro SKU: Nearby Search Pro รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro SKU: Place Details Pro รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro SKU: Text Search Pro รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: Nearby Search Enterprise รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: Nearby Search Enterprise + Atmosphere รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: Place Details Enterprise รายการราคาทั่วโลก
รายการราคาในอินเดีย
Enterprise SKU: Place Details Enterprise + Atmosphere รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: Text Search Enterprise รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: Text Search Enterprise + Atmosphere รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: รูปภาพรายละเอียดสถานที่ รายการราคาทั่วโลก
รายการราคาในอินเดีย
หมวดหมู่รายละเอียด SKU ของ Places API (เดิม)ราคา SKU
Essentials SKU: เติมข้อความอัตโนมัติ - ต่อคำขอ รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: การเติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) - ต่อเซสชัน รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials

SKU: ข้อมูลพื้นฐาน

ค่าใช้จ่ายเพิ่มเติม

รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: Find Place - ID only รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: Place Details Essentials - ID Refresh รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: การเติมข้อความค้นหาอัตโนมัติ - ต่อคำขอ รายการราคาทั่วโลก
รายการราคาในอินเดีย
Pro SKU: การเติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ - ต่อเซสชัน รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro

SKU: Find Place

ค่าใช้จ่ายเพิ่มเติม:

รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro

SKU: Places - Nearby Search

ค่าใช้จ่ายเพิ่มเติม

รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro

SKU: Places - Text Search

ค่าใช้จ่ายเพิ่มเติม

รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro

SKU: รายละเอียดสถานที่

ค่าใช้จ่ายเพิ่มเติม

รายการราคาทั่วโลก
รายการราคาในอินเดีย
Enterprise

SKU: ข้อมูลบรรยากาศ

ค่าใช้จ่ายเพิ่มเติม

รายการราคาทั่วโลก
รายการราคาในอินเดีย
Enterprise

SKU: ข้อมูลติดต่อ

ค่าใช้จ่ายเพิ่มเติม:

รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: Place Photos รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย

ขีดจำกัดการใช้งาน

หากต้องการตรวจสอบและจัดการโควต้าและขีดจำกัดการใช้งาน โปรดดูโควต้าและการแจ้งเตือนโควต้า

  • Places API (ใหม่): การจำกัดอัตราคำขอต่อนาทีคือต่อเมธอด API ต่อโปรเจ็กต์ กล่าวคือ เมธอด API แต่ละรายการจะมีโควต้าแยกกัน

  • Places API (เดิม): ระบบจะคำนวณการจำกัดอัตราคำขอต่อนาทีเป็นผลรวมของคำขอฝั่งไคลเอ็นต์และฝั่งเซิร์ฟเวอร์สำหรับแอปพลิเคชันทั้งหมดที่ใช้ข้อมูลเข้าสู่ระบบของโปรเจ็กต์เดียวกัน

กลยุทธ์ที่มีประสิทธิภาพด้านต้นทุนสำหรับ Places API

ส่วนนี้จะอธิบายวิธีเพิ่มประสิทธิภาพการใช้งานและลดค่าใช้จ่ายที่เกี่ยวข้องกับ Places API

ใช้ฟิลด์มาสก์

การใช้การมาสก์ฟิลด์ช่วยให้มั่นใจได้ว่าคุณจะไม่ขอข้อมูลที่ไม่จำเป็น ซึ่งจะช่วยลดเวลาในการตอบสนองและค่าใช้จ่ายในการเรียกเก็บเงิน

สำหรับคำขอรายละเอียดสถานที่ (ใหม่), การค้นหาในบริเวณใกล้เคียง (ใหม่) และการค้นหาข้อความ (ใหม่) ให้ใช้มาสก์ฟิลด์เพื่อระบุรายการฟิลด์ที่จะแสดงผลในการตอบกลับ

จากนั้นระบบจะเรียกเก็บเงินจากคุณตาม SKU สูงสุดที่เกี่ยวข้องกับคำขอของคุณ เช่น หากเลือกฟิลด์จากทั้ง SKU ของ Essentials และ Pro ระบบจะเรียกเก็บเงินจากคุณตาม SKU ของ Pro

ใช้ราคาเซสชันกับรายละเอียดสถานที่ (ใหม่)

หากแอปพลิเคชันของคุณมีปริมาณการโทรรายเดือนตั้งแต่ 100,001–500,000 หรือมากกว่า หรือหากผู้ใช้ส่งคำขอการเติมข้อความอัตโนมัติมากกว่า 12 รายการต่อเซสชัน Google ขอแนะนำให้ใช้เซสชันที่มีการเติมข้อความอัตโนมัติ (ใหม่) เซสชันช่วยให้การกำหนดราคาเป็นเรื่องง่าย และมอบรูปแบบการกำหนดราคาที่สอดคล้องกันเพื่อใช้กับ การเติมข้อความอัตโนมัติ (ใหม่)

ดูข้อมูลเพิ่มเติมได้ที่การเติมข้อความอัตโนมัติ (ใหม่) และราคาเซสชัน

ปรับโควต้า

ขีดจำกัดโควต้าจะกำหนดจำนวนคำขอสูงสุดที่อนุญาตสำหรับ API หรือบริการหนึ่งๆ ภายในกรอบเวลาที่กำหนด เมื่อจำนวนคำขอในโปรเจ็กต์ถึงขีดจำกัดโควต้า บริการจะหยุดตอบสนองต่อคำขอ

หากต้องการแก้ไขค่าโควต้าสำหรับ API ให้ทำตามขั้นตอนต่อไปนี้

  1. ในคอนโซล Cloud ให้ไปที่ Google Maps Platform > โควต้า
  2. เลือก API ที่ต้องการแก้ไขโควต้า
  3. ระบุค่าโควต้าที่ต้องการเปลี่ยนแปลง แล้วเลือกโดยใช้ช่องทำเครื่องหมาย
  4. คลิกแก้ไข ป้อนค่าโควต้าใหม่ แล้วคลิกส่งคำขอ

ดูคำขอเพิ่มโควต้า

วิธีดูคำขอเพิ่มโควต้าทั้งหมด รวมถึงคำขอที่ผ่านมาและคำขอที่รอดำเนินการ

  1. ในคอนโซล Cloud ให้ไปที่ Google Maps Platform > โควต้า
  2. เลือก API ที่ต้องการดูคำขอเพิ่มโควต้า
  3. คลิกคำขอเพิ่ม

ข้อจำกัดของข้อกำหนดในการใช้งาน

ดูข้อมูลเกี่ยวกับข้อกำหนดในการใช้งานได้ที่นโยบายสำหรับ Places API และส่วนข้อจำกัดของใบอนุญาต ในข้อกำหนดในการให้บริการของ Google Maps Platform