การใช้งานและการเรียกเก็บเงิน Maps JavaScript API

การช่วยเตือน: หากต้องการใช้ Maps JavaScript API คุณต้องเปิดใช้การเรียกเก็บเงินในแต่ละโปรเจ็กต์ และใส่คีย์ API หรือโทเค็น OAuth กับคำขอ API หรือ SDK ทั้งหมด

คลิกไอคอนข้อมูล info เพื่อดูสารบัญของหน้านี้

คำขอ Maps JavaScript API จะสร้างการเรียกไปยัง SKU ที่แตกต่างกันโดยขึ้นอยู่กับประเภทของคำขอ เช่น การโหลดแผนที่จะทริกเกอร์ SKU แผนที่แบบไดนามิก และภาพพาโนรามาจะทริกเกอร์ SKU ของ Street View แบบไดนามิก การเรียกใช้ Places Library, Maps JavaScript API และบริการ JavaScript อื่นๆ จะมีราคาแยกต่างหาก ดูข้อมูลเพิ่มเติมได้ที่รายละเอียด SKU และรายการราคาในตารางต่อไปนี้

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

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

หมวดหมู่	รายละเอียด SKU ของ Maps	ราคา SKU
Essentials	SKU: แผนที่แบบไดนามิก	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: Static Street View	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Dynamic Street View	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Elevation	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Immersive Maps	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
หมวดหมู่	รายละเอียด SKU ของ Places Library, Maps JavaScript API (ใหม่)	ราคา SKU
Essentials	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: รายละเอียดสถานที่ระดับองค์กร	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: รายละเอียดสถานที่ระดับองค์กร + บรรยากาศ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: Text Search Enterprise	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: Text Search Enterprise + Atmosphere	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: รูปภาพรายละเอียดสถานที่	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
หมวดหมู่	รายละเอียด SKU ของ Places Library, Maps JavaScript API (เดิม)	ราคา SKU
Essentials	SKU: การเติมข้อความอัตโนมัติ - ต่อคำขอ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: การเติมข้อความอัตโนมัติ (รวมอยู่ในรายละเอียดสถานที่) - ต่อเซสชัน	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: ข้อมูลพื้นฐาน ค่าใช้จ่ายเพิ่มเติม: SKU: รายละเอียดสถานที่ SKU: ค้นหาสถานที่ SKU: Places - การค้นหาในบริเวณใกล้เคียง SKU: Places - การค้นหาข้อความ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: ค้นหาสถานที่ - รหัสเท่านั้น	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: รายละเอียดสถานที่ Essentials - การรีเฟรชรหัส	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: Query Autocomplete - ต่อคำขอ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: การเติมข้อความอัตโนมัติโดยไม่มีรายละเอียดสถานที่ - ต่อเซสชัน	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: ค้นหาสถานที่ ค่าใช้จ่ายเพิ่มเติม: SKU: ข้อมูลพื้นฐาน SKU: ข้อมูลติดต่อ SKU: ข้อมูลบรรยากาศ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Places - การค้นหาในบริเวณใกล้เคียง ค่าใช้จ่ายเพิ่มเติม: SKU: ข้อมูลพื้นฐาน SKU: ข้อมูลติดต่อ SKU: ข้อมูลบรรยากาศ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Places - การค้นหาข้อความ ค่าใช้จ่ายเพิ่มเติม: SKU: ข้อมูลพื้นฐาน SKU: ข้อมูลติดต่อ SKU: ข้อมูลบรรยากาศ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: รายละเอียดสถานที่ ค่าใช้จ่ายเพิ่มเติม: SKU: ข้อมูลพื้นฐาน SKU: ข้อมูลติดต่อ SKU: ข้อมูลบรรยากาศ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: ข้อมูลบรรยากาศ ค่าใช้จ่ายเพิ่มเติม: SKU: รายละเอียดสถานที่ SKU: ค้นหาสถานที่ SKU: Places - การค้นหาในบริเวณใกล้เคียง SKU: Places - การค้นหาข้อความ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: ข้อมูลติดต่อ ค่าใช้จ่ายเพิ่มเติม: SKU: รายละเอียดสถานที่ SKU: ค้นหาสถานที่ SKU: Places - การค้นหาในบริเวณใกล้เคียง SKU: Places - การค้นหาข้อความ	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Enterprise	SKU: Places Photos	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
หมวดหมู่	Places UI Kit	ราคา SKU
Essentials	SKU: Places UI Kit Query	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: Places UI Kit - การเติมข้อความอัตโนมัติต่อเซสชัน	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Places UI Kit (ขั้นสูง)	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
หมวดหมู่	รายละเอียด SKU ของ Routes Library	ราคา SKU
Essentials	SKU: Routes: Compute Routes Essentials	รายการราคาทั่วโลก รายการราคาในอินเดีย
Essentials	SKU: Routes: Compute Route Matrix Essentials	รายการราคาทั่วโลก รายการราคาในอินเดีย
Pro	SKU: Routes: Compute Routes Pro	รายการราคาทั่วโลก รายการราคาในอินเดีย
Pro	SKU: Routes: Compute Route Matrix Pro	รายการราคาทั่วโลก รายการราคาในอินเดีย
Enterprise	SKU: Routes: Compute Routes Enterprise	รายการราคาทั่วโลก รายการราคาในอินเดีย
Enterprise	SKU: Routes: Compute Route Matrix Enterprise	รายการราคาทั่วโลก รายการราคาในอินเดีย
หมวดหมู่	รายละเอียด SKU ของ Routes API (เดิม)	ราคา SKU
Essentials	SKU: เส้นทาง	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Essentials	SKU: Distance Matrix	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Directions Advanced	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย
Pro	SKU: Distance Matrix Advanced	รายการราคาสำหรับทั่วโลก รายการราคาสำหรับอินเดีย

รายละเอียดราคาของ Routes Library

คลาส Route และ RouteMatrix แต่ละคลาสมี SKU 3 รายการที่กำหนดค่าใช้จ่ายของคำขอ SKU ที่ใช้ในการกำหนดค่าใช้จ่ายจะขึ้นอยู่กับบริการที่คุณใช้ คลาส Route หรือคลาส RouteMatrix และฟีเจอร์ที่คุณใช้ในคำขอ เช่น

• ระบบจะเรียกเก็บเงินคำขอคำนวณเส้นทางสำหรับคำขอแต่ละรายการ

• ระบบจะเรียกเก็บเงินคำขอคำนวณเมตริกซ์เส้นทางต่อองค์ประกอบที่แสดงผลจากคำขอ จำนวนองค์ประกอบคือจำนวนต้นทางคูณด้วยจำนวนปลายทาง ตัวอย่างเช่น หากคำขอมีต้นทาง 2 แห่งและปลายทาง 3 แห่ง ระบบจะเรียกเก็บเงินสำหรับคำขอดังกล่าวเป็น 6 องค์ประกอบ

ฟีเจอร์ที่คุณใช้จะเป็นตัวกำหนดหมวดหมู่ SKU ที่จะเรียกเก็บเงิน ดังนี้

• Essentials: เรียกเก็บเงินสำหรับคำขอที่ใช้เฉพาะฟีเจอร์พื้นฐานที่มีจุดอ้างอิงระดับกลางสูงสุด 10 จุด

• Pro: เรียกเก็บเงินสำหรับคำขอที่ใช้ฟีเจอร์ขั้นสูง เช่น ตัวปรับแต่งเส้นทาง TRAFFIC_AWARE หรือ TRAFFIC_AWARE_OPTIMAL

• Enterprise: เรียกเก็บเงินสำหรับคำขอที่ใช้ฟีเจอร์ระดับองค์กร เช่น การกำหนดเส้นทางสำหรับรถ 2 ล้อ

ขีดจำกัดการใช้งานต่อไปนี้มีผลกับ JavaScript

คำนวณเส้นทาง

• จำกัดอัตราคำขอที่ 3,000 รายการต่อนาที

• จำนวนจุดอ้างอิงระหว่างทางสูงสุดที่อนุญาตต่อคำขอ computeRoutes คือ 25 จุด

คำนวณเมทริกซ์เส้นทาง

• ขีดจำกัดอัตราคำขอคือ 3,000 องค์ประกอบต่อนาที โดยคำนวณจากจำนวนต้นทางคูณด้วยจำนวนปลายทาง

• จำนวนต้นทางและปลายทางสูงสุดที่อนุญาตซึ่งคุณระบุได้โดยใช้รหัสสถานที่หรือที่อยู่คือ 50 รายการ

• จำนวนองค์ประกอบทั้งหมดสูงสุดที่อนุญาตต่อคำขอ computeRouteMatrix โดยตั้งค่า routingPreference เป็น TRAFFIC_AWARE_OPTIMAL คือ 100

• จำนวนองค์ประกอบทั้งหมดสูงสุดที่อนุญาตต่อคำขอ computeRouteMatrix โดยตั้งค่า travelMode เป็น TRANSIT คือ 100

• จำนวนองค์ประกอบทั้งหมดสูงสุดที่อนุญาตต่อคำขอ computeRouteMatrix คือ 625 รายการ

โควต้าและขีดจำกัดการใช้งาน

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

โควต้าการโหลดแผนที่

โควต้าต่อไปนี้ใช้กับการโหลดแผนที่ 2 มิติและ 3 มิติของ Maps JavaScript API

• การโหลดแผนที่ 30,000 ครั้งต่อนาทีต่อโปรเจ็กต์
• การโหลดแผนที่ 300 ครั้งต่อนาทีต่อ IP

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

Places UI Kit มีขีดจำกัดการใช้งานดังต่อไปนี้

• คำค้นหา Places UI Kit: คำขอจากองค์ประกอบรายละเอียดสถานที่และการค้นหาสถานที่จำกัดไว้ที่ 6,000 คำค้นหาต่อนาทีต่อโปรเจ็กต์

• เซสชัน Places UI Kit: คำขอจากองค์ประกอบเติมข้อความอัตโนมัติจำกัดไว้ที่ 6,000 คำค้นหาต่อนาทีต่อโปรเจ็กต์

คำขอที่สำคัญไปยัง Places API และ Geocoding 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. คลิกแก้ไข ป้อนค่าโควต้าใหม่ แล้วคลิกส่งคำขอ

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

สำคัญ: คุณต้องมีสิทธิ์ IAM ที่เหมาะสมในการดูคำขอเพิ่มโควต้า

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

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

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

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

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