การรายงาน Google Maps Platform

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

ประเภทของรายงานมีดังนี้

  • รายงานการใช้งาน: รายงานจำนวนคำขอที่โปรเจ็กต์ของคุณส่งไปยัง Google Maps Platform API โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์
  • รายงานโควต้า: รายงานการใช้โควต้าในกราฟที่จัดกลุ่มได้ใน คำขอต่อนาที โควต้าปัจจุบันสำหรับ API ที่เลือกจะแสดงในตารางใต้กราฟการใช้โควต้า
  • รายงานการเรียกเก็บเงิน: รายงานค่าใช้จ่ายตามช่วงเวลาเป็นแผนภูมิเส้นแบบซ้อน ดู การใช้งานโควต้าของเดือนปัจจุบัน รวมถึงเครดิตเฉพาะการใช้งาน ที่ใช้ ตลอดจนค่าใช้จ่ายทั้งหมดที่คาดการณ์ไว้สำหรับทั้งเดือนปัจจุบัน

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

ดูรายงานการใช้งาน โควต้า และการเรียกเก็บเงินของ Google Maps Platform ได้โดยใช้ Cloud Console

รายงานการใช้งาน

การใช้งานจะขึ้นอยู่กับจำนวนคำขอที่โปรเจ็กต์ของคุณส่งไปยัง Google Maps Platform APIs โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์ คำขอประกอบด้วยคำขอที่สำเร็จ คำขอที่ทำให้เกิดข้อผิดพลาดของเซิร์ฟเวอร์ และคำขอที่ทำให้เกิดข้อผิดพลาดของไคลเอ็นต์ ข้อมูลเข้าสู่ระบบประกอบด้วยคีย์ API และรหัสไคลเอ็นต์ (สำหรับโปรเจ็กต์ในแพ็กเกจ Premium และโปรเจ็กต์ในแพ็กเกจ Premium ที่ย้ายข้อมูล) โปรดดูรายละเอียดที่ภาพรวมแพ็กเกจ Premium และข้อมูลเกี่ยวกับการใช้รหัสไคลเอ็นต์

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

  • API ทั้งหมด: คุณสามารถกรองและจัดกลุ่มเมตริกการใช้งานสำหรับ API ทั้งหมดได้ด้วยวิธีต่อไปนี้

    • กรองตามระยะเวลาและ API
    • ดูการรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองที่จัดกลุ่มตามรหัสการตอบกลับ, API และ ข้อมูลเข้าสู่ระบบ
  • API ที่เฉพาะเจาะจง: คุณสามารถกรองและจัดกลุ่มเมตริกการใช้งานสำหรับ API ที่เฉพาะเจาะจงได้โดยทำดังนี้

    • กรองตามระยะเวลา เวอร์ชัน API ข้อมูลเข้าสู่ระบบ และวิธีการ
    • ดูการรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองที่จัดกลุ่มตามรหัสการตอบกลับ เมธอด API และ เวอร์ชัน รวมถึงข้อมูลเข้าสู่ระบบ

หน้าแดชบอร์ด API และบริการ

แดชบอร์ด API และบริการจะแสดงภาพรวม ของเมตริกการใช้งานสำหรับ API ทั้งหมดที่เปิดใช้สำหรับโปรเจ็กต์ของคุณ ซึ่งได้แก่ API ของ Google Maps Platform รวมถึง API และบริการอื่นๆ

  • หน้าแดชบอร์ดมีกราฟ 3 รายการและตาราง 1 รายการ คุณกรองการใช้งานที่แสดงในกราฟและตารางได้โดยเลือกระยะเวลาตั้งแต่ 1 ชั่วโมงจนถึง 30 วันที่ผ่านมา

  • กราฟการรับส่งข้อมูลแสดงการใช้งานในรูปแบบคำค้นหาต่อนาที (QPM) ต่อ API

  • กราฟข้อผิดพลาดแสดงเปอร์เซ็นต์ของคำขอที่ทำให้เกิดข้อผิดพลาดต่อ API

  • กราฟเวลาในการตอบสนองแสดงเวลาในการตอบสนองมัธยฐานของคำขอต่อ API

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

ตัวอย่าง API การตรวจสอบ

วิธีเข้าถึงหน้าแดชบอร์ด API และบริการ

  1. เปิดหน้าตัวเลือกโปรเจ็กต์ใน Cloud Console โดยทำดังนี้

    หน้าเครื่องมือเลือกโปรเจ็กต์

  2. เลือกโปรเจ็กต์ หน้าแดชบอร์ด API และบริการจะปรากฏขึ้น

    หากหน้าเว็บไม่ปรากฏ ให้เลือกปุ่มเมนู เมนู แล้วเลือก API และบริการ

ดูข้อมูลเพิ่มเติมได้ที่การตรวจสอบการใช้งาน API

หน้าภาพรวมของ Google Maps

หน้าภาพรวมของ Google Maps มีตารางที่แสดงรายการ API ที่เปิดใช้และคำขอการใช้งานในช่วง 30 วันที่ผ่านมา คำขอตาม API จะแสดงในรูปแบบกราฟด้วย กราฟการเรียกเก็บเงินจะแสดงใบเรียกเก็บเงินปัจจุบันและการใช้งานทั้งหมดในช่วง 3 เดือนที่ผ่านมา

แผนภูมิภาพรวมที่แสดงตารางซึ่งแสดงรายการ API ที่เปิดใช้และ
  คำขอ API ในช่วง 30 วันที่ผ่านมา

วิธีเข้าถึงหน้าภาพรวมของ Google Maps Platform

  1. เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้

    ไปที่หน้า Google Maps Platform

  2. เลือกภาพรวมในเมนูด้านซ้าย

หน้า API และบริการของ Google Maps Platform

หน้า API และบริการของ Google Maps มีตาราง ของไทล์ที่แสดงถึง API, SDK และบริการอื่นๆ ที่พร้อมใช้งานสำหรับโปรเจ็กต์ ของคุณ ในแต่ละไทล์ คุณสามารถเปิดหรือปิดใช้บริการนั้นได้โดยเลือกเปิดใช้หรือปิดใช้ และคุณสามารถเข้าถึงข้อมูลเข้าสู่ระบบ เมตริก และคู่มือผู้ใช้สำหรับ API ที่เปิดใช้ได้ นอกจากนี้ คุณยังใช้ตัวกรองหน้าเว็บเพื่อดูบริการที่เปิดหรือปิดใช้ รวมถึงหมวดหมู่บริการอื่นๆ ได้ด้วย

API

วิธีเข้าถึงหน้า API และบริการของ Google Maps Platform

  1. เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้

    ไปที่หน้า Google Maps Platform

  2. เลือก API และบริการในเมนูด้านซ้าย

หน้าเมตริกของ Google Maps

หน้าเมตริกของ Google Maps จะแสดงกราฟ 3 รายการ ได้แก่ การรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองมัธยฐาน ข้อมูลการใช้งานในกราฟสามารถจัดกลุ่มได้ ตามคลาสรหัสการตอบกลับ, API, เมธอด API, ข้อมูลเข้าสู่ระบบ, แพลตฟอร์ม และโดเมน

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

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

หน้าเมตริกแสดงกราฟ 3 กราฟ ได้แก่ การรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองมัธยฐาน

รูปภาพต่อไปนี้แสดงตัวกรองแพลตฟอร์มและโดเมนสำหรับ API ที่เฉพาะเจาะจง เมื่อเลือกการจัดกลุ่มตามแพลตฟอร์มและโดเมนในรายการแบบเลื่อนลงจัดกลุ่มตาม

ตัวกรองแพลตฟอร์มจะปรากฏขึ้นเมื่อเลือก API เดียวเท่านั้น ตัวกรองแพลตฟอร์มจะปรากฏขึ้นเมื่อเลือก API เดียวเท่านั้น

วิธีเข้าถึงหน้าเมตริก API ของ Google Maps Platform

  1. เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้

    ไปที่หน้า Google Maps Platform

  2. เลือกเมตริกในเมนูด้านซ้าย

การรายงานข้อมูลเข้าสู่ระบบ

คุณสามารถกรองและจัดกลุ่มเมตริกตามข้อมูลเข้าสู่ระบบที่ใช้โหลด API

รูปแบบข้อมูลเข้าสู่ระบบ ความหมาย
ชื่อคีย์
เช่น "คีย์แอปบนอุปกรณ์เคลื่อนที่"
ใช้คีย์ API เพื่อโหลด API โดยใช้ ?key=...: คุณดูชื่อคีย์ได้ใน Maps Platform Console ในส่วนคีย์และข้อมูลเข้าสู่ระบบ
หมายเลขโปรเจ็กต์
เช่น "project_number:123456" โดยที่ 123456 คือหมายเลขโปรเจ็กต์
หากเห็นข้อมูลเข้าสู่ระบบนี้ อาจเป็นไปได้ 2 กรณี ดังนี้
  1. สำหรับ API ที่ยอมรับรหัสไคลเอ็นต์ของ Maps Platform: มีการใช้รหัสไคลเอ็นต์ของ Maps Platform เพื่อโหลด API เช่น ใช้ &client=gme-_mycompany_

    API เหล่านี้ยอมรับรหัสไคลเอ็นต์ ได้แก่ Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API (เดิม), Distance Matrix API (เดิม), Geocoding API และ Time Zone API ดูข้อมูลเพิ่มเติมได้ที่ การจัดการรหัสไคลเอ็นต์ของแพ็กเกจ Premium

  2. สำหรับ API ที่ยอมรับ OAuth: ระบบโหลด API โดยใช้ OAuth โดยไม่มีคีย์ API

กราฟโค้ดตอบกลับ

กราฟการเข้าชมตามรหัสการตอบกลับและข้อผิดพลาดตามรหัสการตอบกลับจะแบ่ง การใช้งานตามคลาสรหัสการตอบกลับ HTTP ตารางนี้แสดงการแมประหว่างสถานะการตอบกลับของ Google Maps Platform API กับคลาสรหัสการตอบกลับ HTTP ดังนี้

สถานะ Maps API คลาสรหัสการตอบกลับ HTTP - รายงานการใช้งาน
(2xx, 3xx, 4xx, 5xx)
หมายเหตุ
ตกลง 2xx การตอบกลับที่สำเร็จ

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า
ตกลง 3xx การตอบกลับที่สำเร็จ

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า

เช่น คำขอที่สำเร็จของ Place Photo จะแสดงการเปลี่ยนเส้นทาง 302 ไปยังรูปภาพที่อ้างอิง
DATA_NOT_AVAILABLE 4xx(1) การตอบกลับที่สำเร็จซึ่งระบุว่าไม่มีข้อมูลสำหรับสถานที่ตั้งที่ป้อน

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า
ZERO_RESULTS 4xx(1) การตอบกลับที่สำเร็จไม่แสดงผลลัพธ์

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า
NOT_FOUND 4xx(1)

สำหรับ Directions API (เดิม) ข้อความนี้ระบุว่าระบบไม่สามารถเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่อย่างน้อย 1 แห่งที่ระบุใน ต้นทาง ปลายทาง หรือจุดแวะพักของคำขอ

สำหรับ Places API ข้อความนี้ระบุว่าไม่พบสถานที่ที่อ้างอิง (place_id) ในฐานข้อมูล Places

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า

INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง)
MAX_WAYPOINTS_EXCEEDED
MAX_ROUTE_LENGTH_EXCEEDED และอื่นๆ
4xx ข้อผิดพลาดที่เกิดจากค่าพารามิเตอร์ไม่ถูกต้อง ดูรายละเอียดเพิ่มเติมได้ในการตอบกลับของ API

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า
REQUEST_DENIED 4xx ข้อผิดพลาดของไคลเอ็นต์ที่เกิดจากข้อผิดพลาดในการตรวจสอบสิทธิ์ ข้อผิดพลาดในการเข้าถึง และอื่นๆ ดูรายละเอียดเพิ่มเติมได้ในการตอบกลับของ API
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
rateLimitExceeded,
dailyLimitExceeded,
userRateLimitExceeded
4xx ข้อผิดพลาดของไคลเอ็นต์เกิดจากคำขอมากเกินไปต่อระยะเวลาที่อนุญาต โปรดลองส่งคำขออีกครั้งในภายหลัง ดูรายละเอียดเพิ่มเติมได้ในการตอบกลับของ API
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้องหรือไม่มี พารามิเตอร์ การแยกวิเคราะห์คำขอ หรือข้อผิดพลาดในการตรวจสอบ) 4xx ข้อผิดพลาดของไคลเอ็นต์เกิดจากคำขอที่ไม่ถูกต้อง ดูรายละเอียดเพิ่มเติมได้ในการตอบกลับของ API
NOT_FOUND (404) 4xx สำหรับ

Directions API (เดิม) ข้อความนี้บ่งชี้ว่าระบบไม่สามารถเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่อย่างน้อย 1 แห่งที่ระบุใน ต้นทาง ปลายทาง หรือจุดแวะพักของคำขอ

สำหรับ Geolocation API ข้อความนี้บ่งชี้ว่าข้อมูลที่ป้อนไม่เพียงพอที่จะสร้าง ค่าประมาณตำแหน่ง

สำหรับ Roads API ข้อความนี้บ่งชี้ว่าระบบไม่สามารถป้อนข้อมูล ไปยังถนนได้อย่างสมเหตุสมผล

นี่คือคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า

UNKNOWN_ERROR 5xx ข้อผิดพลาดของเซิร์ฟเวอร์ที่บ่งบอกว่าไม่สามารถดำเนินการตามคำขอได้: ข้อผิดพลาดภายใน บริการทำงานหนักเกินไป ไม่พร้อมใช้งาน หมดเวลา และอื่นๆ

1 เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด Google Maps Platform API จะย้ายข้อมูลจาก 1) คลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx สำหรับ สถานะ Maps API: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status 2) คลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx สำหรับ สถานะ Maps API: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded 3) คลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 5xx สำหรับ สถานะ Maps API: UNKNOWN_ERROR คุณจะเห็นโค้ดตอบกลับทั้ง 2 รายการในช่วงเปลี่ยนผ่าน โค้ดการตอบกลับที่ส่งคืนในการตอบกลับของ Maps API จะไม่เปลี่ยนแปลง ยืนยันว่าการเพิ่มขึ้นของ 4xx และ/หรือ 5xx ในเมตริก Google Maps Platform เกี่ยวข้องกับการย้ายข้อมูลนี้โดยตรวจสอบรหัสการตอบกลับที่เพิ่มขึ้นในเครื่องมือสำรวจเมตริก (ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Cloud Monitoring สำหรับ Google Maps Platform)

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

พารามิเตอร์การระบุแหล่งที่มาของการใช้งาน Google Maps Platform

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

Google จะรวมพารามิเตอร์ internal_usage_attribution_ids ไว้ในการเรียก API เพื่อรวบรวมข้อมูลเกี่ยวกับการใช้งานโค้ดตัวอย่าง เพื่อทำความเข้าใจการใช้งานและวิธีปรับปรุงโซลูชันของเรา

  • ระบบอาจรวมพารามิเตอร์ internal_usage_attribution_ids ไว้ ในโค้ดตัวอย่างของโซลูชันโดยค่าเริ่มต้น
  • พารามิเตอร์จะส่งคืนข้อมูลวิเคราะห์เกี่ยวกับการนำโซลูชันไปใช้ให้ Google เพื่อปรับปรุง คุณภาพของโซลูชันในการทำซ้ำในอนาคต
  • คุณเลือกไม่ใช้ได้โดยลบพารามิเตอร์ internal_usage_attribution_ids และค่าของพารามิเตอร์ออกจากโค้ดตัวอย่าง
  • คุณไม่จำเป็นต้องเก็บพารามิเตอร์ไว้ การนำพารามิเตอร์ออกจะ ไม่ส่งผลต่อประสิทธิภาพ
  • พารามิเตอร์นี้ใช้สำหรับการรายงานการใช้งานโค้ดตัวอย่างเท่านั้น
  • พารามิเตอร์นี้แยกจากการวิเคราะห์และการรายงานที่เฉพาะเจาะจงของ API ซึ่งหมายความว่าการนำพารามิเตอร์ออกจากโค้ดตัวอย่างของโซลูชันจะไม่ ปิดใช้การรายงานภายในของ Maps JavaScript API

รายงานโควต้า

โควต้าจะกำหนดขีดจำกัดจำนวนคำขอที่โปรเจ็กต์ของคุณส่งไปยัง Google Maps Platform APIs ได้ คุณจำกัดคำขอได้ 3 วิธี ได้แก่ ต่อวัน ต่อนาที และต่อผู้ใช้ต่อนาที เฉพาะคำขอที่สำเร็จและคำขอที่ ทำให้เกิดข้อผิดพลาดของเซิร์ฟเวอร์เท่านั้นที่จะนับรวมในโควต้า คำขอที่ตรวจสอบสิทธิ์ไม่สำเร็จจะไม่นับรวมในโควต้า

การใช้งานโควต้าจะแสดงในกราฟในหน้าโควต้าใน Cloud Console และจัดกลุ่มได้ในคำขอต่อนาที โควต้าปัจจุบันสำหรับ API ที่เลือกจะแสดงในตารางด้านล่างกราฟการใช้โควต้า

หากต้องการดูค่าโควต้าต่อนาทีสำหรับผลิตภัณฑ์ GMP API ใดก็ตาม ให้ใช้ เครื่องคิดเลขนี้

หน้าโควต้าของ Google Maps

หน้าโควต้าของ Google Maps จะแสดงขีดจำกัดโควต้าและการใช้โควต้า สำหรับ API ที่คุณเลือก

แผนภูมิการใช้งานโควต้าใน Google Cloud Console จะแสดงการเข้าชมทั้งหมดสำหรับ คีย์ API และรหัสไคลเอ็นต์ การรับส่งรหัสไคลเอ็นต์ยังพร้อมใช้งานในแผนภูมิเมตริก ใน Cloud Console ด้วย

หน้านี้จะแสดงเฉพาะคำขอที่ใช้โควต้า ได้แก่ คำขอที่สำเร็จ (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) และคำขอที่ทำให้เกิดข้อผิดพลาดของเซิร์ฟเวอร์ (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (ค่าพารามิเตอร์ไม่ถูกต้อง) และ UNKNOWN_ERROR)

คำขอที่ทำให้เกิดข้อผิดพลาดฝั่งไคลเอ็นต์ ได้แก่ ข้อผิดพลาดในการตรวจสอบสิทธิ์ การให้สิทธิ์ และอาร์กิวเมนต์ที่ไม่ถูกต้อง (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง ข้อผิดพลาดในการแยกวิเคราะห์คำขอ)) จะไม่ใช้โควต้าและจะไม่แสดง

หน่วยโควต้าคือคำขอสำหรับ API ของแพลตฟอร์ม Google Maps ส่วนใหญ่ ( Maps Static API, Street View Static API, Geocoding API, Directions API (เดิม), Places API, Time Zone API, Geolocation API และ Elevation API) แต่มีข้อยกเว้นบางประการดังนี้

  • สำหรับ Distance Matrix API (เดิม) หน่วยโควต้าคือองค์ประกอบ ซึ่งเป็นคู่ต้นทาง-ปลายทาง
  • สำหรับ Maps JavaScript API หน่วยโควต้าคือการโหลดแผนที่
  • สำหรับ Maps SDK สำหรับ Android และ Maps SDK สำหรับ iOS หน่วยโควต้าคือคำขอ Street View หรือการโหลดภาพพาโนรามา การโหลดแผนที่จะไม่มีค่าใช้จ่ายและไม่ใช้โควต้า

หน้าโควต้าของ Maps ในคอนโซล Google Cloud ที่แสดงโควต้าตาม API โดยใช้ตัวเลือก จากนั้นจะแสดงการโหลดแผนที่ที่เกี่ยวข้องกับโควต้าที่ตั้งไว้สำหรับ API ที่เกี่ยวข้อง

วิธีเข้าถึงหน้าโควต้าของ Google Maps Platform

  1. เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้

    ไปที่หน้า Google Maps Platform

  2. เลือกโควต้าในเมนูด้านซ้าย
  3. เลือก API จากรายการแบบเลื่อนลงของ API

หน่วยโควต้า

ตารางนี้แสดงหน่วยโควต้าสำหรับ Google Maps Platform API

Google Maps Platform API หน่วยโควต้า
Maps
Maps SDK สำหรับ Android 1 พาโนรามา
Maps SDK สำหรับ iOS 1 พาโนรามา
Map Tiles API คำขอ 1 รายการ
Maps Aerial View API คำขอ 1 รายการ
Maps Static API คำขอ 1 รายการ
Maps JavaScript API 1 การโหลดแผนที่
Street View Static API คำขอ 1 รายการ
Maps Embed API 1 การโหลดแผนที่
เส้นทาง
Routes API (คำนวณเส้นทาง) คำขอ 1 รายการ
Routes API (คำนวณเมทริกซ์เส้นทาง) 1 องค์ประกอบ (คู่ต้นทาง-ปลายทาง)
Directions API (เดิม) คำขอ 1 รายการ
Distance Matrix API (เดิม) 1 องค์ประกอบ (คู่ต้นทาง-ปลายทาง)
Roads API คำขอ 1 รายการ
Route Optimization API คำขอ 1 รายการ
Navigation SDK สำหรับ Android 1 ปลายทาง
Navigation SDK สำหรับ iOS 1 ปลายทาง
สถานที่
Places API คำขอ 1 รายการ
Places Aggregate API คำขอ 1 รายการ
Address Validation API คำขอ 1 รายการ
Geocoding API คำขอ 1 รายการ
Geolocation API คำขอ 1 รายการ
Time Zone API คำขอ 1 รายการ
สภาพแวดล้อม
Air Quality API (CurrentConditions และ HeatmapTile) คำขอ 1 รายการ
Air Quality API (ประวัติ) 1 หน้า
Pollen API คำขอ 1 รายการ
Solar API คำขอ 1 รายการ
Weather API คำขอ 1 รายการ

รายงานการเรียกเก็บเงิน

ดูรายงานการเรียกเก็บเงิน

รายงานการเรียกเก็บเงินสำหรับการใช้ผลิตภัณฑ์ Google Maps Platform จะอยู่ในคอนโซล Google Cloud ดูข้อมูลเพิ่มเติมได้ที่การเรียกเก็บเงิน

วิธีเข้าถึงรายงานการเรียกเก็บเงิน

  1. เปิดหน้าตัวเลือกโปรเจ็กต์ใน Cloud Console โดยทำดังนี้

    หน้าเครื่องมือเลือกโปรเจ็กต์

  2. เลือกโปรเจ็กต์
  3. เลือกปุ่มเมนู เมนู แล้วเลือกการเรียกเก็บเงิน
  4. หากมีบัญชีสำหรับการเรียกเก็บเงินหลายบัญชี ให้เลือกไปที่บัญชีสำหรับการเรียกเก็บเงินที่ลิงก์ เพื่อเปิดหน้าภาพรวมของบัญชีสำหรับการเรียกเก็บเงินที่ลิงก์
  5. ในเมนูด้านซ้าย ให้เลือกรายงานเพื่อเปิดหน้ารายงานการเรียกเก็บเงิน สำหรับบัญชีสำหรับการเรียกเก็บเงินที่ลิงก์

วิธีอ่านแผนภูมิรายงานการเรียกเก็บเงิน

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

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

เคล็ดลับ: วิเคราะห์การใช้งานและต้นทุนต่อ SKU

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

รายงานการเรียกเก็บเงินที่จัดกลุ่มตาม SKU
รูปที่ 2: ตารางการเรียกเก็บเงินที่แสดงรายการโฆษณาการใช้งานและค่าใช้จ่ายตาม SKU
ภาพหน้าจอของตัวกรองรายงานการเรียกเก็บเงิน
รูปที่ 3: ตัวกรองรายงานการเรียกเก็บเงิน
วิธีเปลี่ยนมุมมองรายงานเพื่อแสดงรายการโฆษณาตาม SKU
  1. ในแผงทางด้านขวาของแผนภูมิ ให้ขยายตัวกรองจัดกลุ่มตาม
  2. เลือก SKU

ตัวกรองรายงานการเรียกเก็บเงินอื่นๆ ที่ใช้ได้ ได้แก่ ช่วงเวลา โปรเจ็กต์ ผลิตภัณฑ์ SKU และสถานที่ตั้ง ซึ่งช่วยให้คุณกรองตามตำแหน่ง ที่คำขอ API ได้รับการแสดง

หากต้องการจัดหมวดหมู่แหล่งที่มาของการใช้งานนอกเหนือจากผลิตภัณฑ์ ให้จัดกลุ่มรายงานการเรียกเก็บเงิน ตามค่าใดค่าหนึ่งที่ระบุไว้ คีย์ 3 รายการที่เกี่ยวข้องกับ Google Maps Platform API คือ goog-maps-api-key-suffix (อักขระ 4 ตัวสุดท้าย ของคีย์ API), goog-maps-platform-type (แพลตฟอร์ม: Android, iOS, JavaScript หรือเว็บเซอร์วิส) และ goog-maps-channel (ค่าช่องทางตัวเลขชุดหนึ่ง จากการค้นหา API) ข้อมูลเพิ่มเติมเกี่ยวกับการกรองและการจัดกลุ่ม

คุณเปลี่ยนมุมมองแผนภูมิเพื่อยกเว้นเครดิตเฉพาะการใช้งานได้โดยยกเลิกการเลือกช่องทําเครื่องหมายรวมเครดิตในต้นทุนในแผงด้านขวา

ตรวจสอบและจำกัดการใช้งาน

คุณสามารถทำสิ่งต่อไปนี้เพื่อช่วยวางแผนงบประมาณและควบคุมค่าใช้จ่าย

  • กำหนดงบประมาณ

    การแจ้งเตือนเพื่อติดตามการเพิ่มขึ้นของการใช้จ่ายจนถึงจำนวนที่ต้องการ งบประมาณไม่ได้จำกัดการใช้ API แต่จะแจ้งเตือนคุณเมื่อจำนวนเงินที่ใช้ ใกล้ถึงจำนวนเงินที่ระบุ

  • จำกัด API รายวัน

    การใช้งานเพื่อจัดการค่าใช้จ่ายในการใช้ API ที่เรียกเก็บเงินได้ การกำหนดขีดจำกัดสำหรับคำขอต่อวันจะช่วยจำกัดการใช้จ่ายได้ ใช้สมการเพื่อกำหนด ขีดจำกัดรายวันตามจำนวนเงินที่ต้องการใช้จ่าย เช่น (ค่าใช้จ่ายรายเดือน / ราคาต่อ SKU แต่ละรายการ) / 30 = ขีดจำกัดคำขอต่อวัน (สำหรับ API หนึ่งรายการ)

การติดตามการใช้งานต่อช่อง

หากต้องการติดตามการใช้งานโดยใช้ช่องทางที่เป็นตัวเลข คุณต้องเพิ่มพารามิเตอร์ "channel" ลงในคำขอ API ค่าแชแนลที่ยอมรับได้มีเพียงตัวเลข 0-999 ลองดูตัวอย่างต่อไปนี้

  • Geocoding Web Service API
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

ตรวจสอบการใช้งานช่องได้โดยตรงในรายงานการเรียกเก็บเงิน การใช้งานแชแนลจะอยู่ ในส่วนป้ายกำกับเป็นคีย์ goog-maps-channel

วิธีกรองโดยใช้ป้ายกำกับ
รูปที่ 4: กรองตาม SKU และช่องทาง
วิธีกรองรายงานการเรียกเก็บเงินตาม SKU และช่องทาง
  1. ใช้ตัวกรอง Group by SKU
  2. เลือกแคร์เร็ตป้ายกำกับ
  3. จากเมนูแบบเลื่อนลงคีย์ ให้เลือก goog-maps-channel
  4. จากเมนูแบบเลื่อนลงค่า ให้เลือกแชแนลที่เป็นตัวเลขที่คุณต้องการ กรอง

จัดกลุ่มตามคีย์ป้ายกำกับ goog-maps-channel เพื่อดูต้นทุนที่เกิดจากแต่ละแชแนล

เมื่อคุณใช้ข้อมูลการใช้งานแชแนลในคำขอแล้ว อาจมี ความล่าช้าเล็กน้อย (สูงสุด 24 ชั่วโมง) ก่อนที่ข้อมูลจะแสดงในรายงานการเรียกเก็บเงิน

ส่งออกข้อมูลการเรียกเก็บเงินด้วย BigQuery

นอกจากนี้ คุณยัง ส่งออกข้อมูลการเรียกเก็บเงิน ไปยัง BigQuery ได้ด้วย

ใช้การส่งออก BigQuery เพื่อส่งออกข้อมูลการเรียกเก็บเงินใน Cloud แบบละเอียด (เช่น ข้อมูลการใช้งานและค่าใช้จ่ายโดยประมาณ) โดยอัตโนมัติตลอดทั้งวันไปยัง ชุดข้อมูล BigQuery ที่คุณระบุ จากนั้นคุณสามารถเข้าถึงข้อมูลการเรียกเก็บเงิน จาก BigQuery เพื่อทำการวิเคราะห์อย่างละเอียดได้ ซึ่งจะช่วยให้คุณเข้าใจแหล่งที่มาของการใช้งาน Google Maps Platform ได้ละเอียดยิ่งขึ้น

หากต้องการเริ่มต้นใช้งานการส่งออก BigQuery และการค้นหาข้อมูล คุณ สามารถลองใช้การค้นหาตัวอย่างด้านล่าง ก่อนเรียกใช้การค้นหานี้ คุณต้องดำเนินการต่อไปนี้

  • เปิดใช้การเรียกเก็บเงินและ การส่งออกการเรียกเก็บเงินของ BigQuery ในบัญชี
  • รูปแบบตารางคือ PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID โดยมีรายละเอียดดังนี้
    • PROJECT_ID คือรหัสโปรเจ็กต์จริง (เช่น "my-project-123456")
    • DATASET_NAME คือชื่อชุดข้อมูลที่คุณสร้าง (เช่น "SampleDataSet")
    • BILLING_ACCOUNT_ID คือการอ้างอิงรหัสบัญชีสำหรับการเรียกเก็บเงิน โดยมีคำนำหน้าเป็น "gcp_billing_exportv1" และเปลี่ยนขีดกลาง (-) เป็นขีดล่าง (_) เช่น รหัสบัญชีสำหรับการเรียกเก็บเงิน 123456-7890AB-CDEF01 จะเปลี่ยนเป็น gcp_billing_export_v1_123456_789AB_CDEF01

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

การเรียกเก็บเงินใน Cloud:

Google Maps Platform:

สถานะคำตอบและรายงาน

ตารางด้านล่างแสดงการแมประหว่างสถานะ Maps API, รหัสการตอบกลับ HTTP ที่แสดงในการตอบกลับ Maps API และคลาสรหัสการตอบกลับ HTTP ในรายงานการใช้งาน และ ระบุว่าคำขอที่เกี่ยวข้องปรากฏในรายงานการใช้งาน โควต้า และการเรียกเก็บเงินหรือไม่

รายงานการใช้งานในเมตริก Google Maps Platform

ให้รายละเอียดระดับHTTP response code class หากต้องการระดับความละเอียดที่สูงขึ้น โปรดดูรหัสสถานะการตอบกลับ

ในการตรวจสอบการใช้งาน Google Maps Platform

รหัสการตอบกลับที่ใช้ได้ในการตอบกลับของ Maps API มีอยู่ในรายงานการใช้งาน รายงานต่อ
สถานะ Maps API รหัสการตอบกลับ HTTP คลาสของโค้ดตอบกลับ HTTP การใช้งาน โควต้า การเรียกเก็บเงิน
ตกลง 200,
204,
302
2xx,
3xx
ใช่ ได้ ใช่
DATA_NOT_AVAILABLE,
NOT_FOUND,
ZERO_RESULTS
200,
404
4xx1 ใช่ ได้ ใช่
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง)
MAX_ROUTE_LENGTH_EXCEEDED
MAX_WAYPOINTS_EXCEEDED
ฯลฯ
200,
400
4xx ใช่ ได้ ใช่
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ขาดหายไป ข้อผิดพลาดในการแยกวิเคราะห์คำขอ) 200,
400
4xx ใช่ ไม่ใช่ ไม่
REQUEST_DENIED 200,
400,
403
4xx1 ใช่ ไม่ใช่ ไม่
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 ใช่ ไม่ใช่ ไม่
UNKNOWN_ERROR 200,
500,
503
5xx1 ใช่ ได้ ไม่
1 Google Maps Platform API จะย้ายข้อมูลจากคลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด 1) จากคลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx สำหรับ สถานะ Maps API: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) จากคลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx สำหรับ สถานะ Maps API: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) จากคลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 5xx สำหรับ สถานะ Maps API: UNKNOWN_ERROR คุณจะเห็นโค้ดตอบกลับทั้ง 2 รายการในช่วงเปลี่ยนผ่าน โค้ดการตอบกลับที่ส่งคืนในการตอบกลับของ Maps API จะไม่เปลี่ยนแปลง ยืนยันว่าการเพิ่มขึ้นของ 4xx และ/หรือ 5xx ในเมตริก Google Maps Platform เกี่ยวข้องกับการย้ายข้อมูลนี้โดยตรวจสอบรหัสการตอบกลับที่เพิ่มขึ้นในเครื่องมือสำรวจเมตริก (ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Cloud Monitoring สำหรับ Google Maps Platform)