การใช้งานและการเรียกเก็บเงินของ 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: การค้นหาข้อความ 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: รายละเอียดสถานที่ระดับองค์กร รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Enterprise SKU: รายละเอียดสถานที่ระดับองค์กร + บรรยากาศ รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
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: ค้นหาสถานที่ - รหัสเท่านั้น รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: Place Details Essentials - ID Refresh รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Essentials SKU: Query Autocomplete - ต่อคำขอ รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro SKU: การเติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ - ต่อเซสชัน รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
Pro

SKU: ค้นหาสถานที่

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

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

SKU: Places - การค้นหาในบริเวณใกล้เคียง

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

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

SKU: Places - การค้นหาข้อความ

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

รายการราคาสำหรับทั่วโลก
รายการราคาสำหรับอินเดีย
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