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

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

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

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

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

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

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

การใช้งานจะอิงตามจำนวนคำขอที่โปรเจ็กต์ส่งไปยัง API ของ Google Maps Platform โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์ คำขอรวมถึงคำขอที่สำเร็จ คำขอที่ทำให้เกิดข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ และคำขอที่ทำให้เกิดข้อผิดพลาดเกี่ยวกับไคลเอ็นต์ ข้อมูลเข้าสู่ระบบประกอบด้วยคีย์ API และรหัสไคลเอ็นต์ (สำหรับโปรเจ็กต์แพ็กเกจพรีเมียมและแพ็กเกจพรีเมียมที่ย้ายข้อมูลแล้ว) โปรดดูรายละเอียดที่ภาพรวมของแพ็กเกจ 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 และบริการที่เปิดใช้ คำขอคือจำนวนคำขอ (สำหรับระยะเวลาที่เลือก) ข้อผิดพลาดคือจำนวนคำขอเหล่านี้ที่ทำให้เกิดข้อผิดพลาด เวลาในการตอบสนอง (เวลาในการตอบสนองเฉลี่ยและเปอร์เซ็นไทล์) คือเวลาในการตอบสนองสำหรับคำขอเหล่านี้

ตัวอย่าง Monitoring API

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

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

    หน้าตัวเลือกโปรเจ็กต์

  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 โดยทำดังนี้

    ไปที่หน้า 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 ตารางนี้แสดงการแมประหว่างสถานะการตอบกลับจาก API ของ Google Maps Platform กับคลาสโค้ดตอบกลับ HTTP

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

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

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

เช่น คำขอรูปภาพสถานที่ ที่สำเร็จจะแสดงการเปลี่ยนเส้นทาง 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 ที่คุณสนใจ (เช่น การตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์หรือการตอบกลับเส้นทาง)

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

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

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 และจัดกลุ่มเป็นคำขอต่อนาทีได้ โควต้าปัจจุบันสำหรับ API ที่เลือกจะแสดงในตารางใต้กราฟการใช้โควต้า

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

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

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

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

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

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

หน่วยโควต้าคือคำขอสำหรับ API ส่วนใหญ่ของ Google Maps Platform ( 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 คำขอ
Maps Grounding Lite 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 โดยทำดังนี้

    หน้าตัวเลือกโปรเจ็กต์

  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 รายวัน

    usage เพื่อจัดการค่าใช้จ่ายในการใช้ 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. ใช้ตัวกรอง SKU กลุ่มตาม
  2. เลือกเครื่องหมายแครอทป้ายกำกับ
  3. จากเมนูแบบเลื่อนลงคีย์ ให้เลือก goog-maps-channel
  4. จากเมนูแบบเลื่อนลงค่า ให้เลือกแชแนลตัวเลขที่ต้องการกรอง

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

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

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

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

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

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

  • เปิดใช้การเรียกเก็บเงินและ การส่งออกการเรียกเก็บเงินของ 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 เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด API ของ Google Maps Platform กำลังย้ายข้อมูลดังนี้ 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)