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

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

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

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

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

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

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

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

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

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

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

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

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

กราฟการเข้าชมแสดงการใช้งานในการค้นหาต่อวินาที (QPS) ต่อ 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. เลือกภาพรวมในเมนูด้านซ้าย

หน้า Google Maps Platform API

หน้า API ของ Google Maps มี 2 ตาราง ตาราง API ที่เปิดใช้แสดงจำนวนคำขอ จำนวนข้อผิดพลาด และเวลาในการตอบสนองโดยเฉลี่ยสำหรับ API ที่เปิดใช้แต่ละรายการในช่วง 30 วันที่ผ่านมา ตาราง API เพิ่มเติมจะแสดง API ที่ไม่ได้เปิดใช้

apis

วิธีเข้าถึงหน้า Google Maps Platform API

  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 ตัวเดียว

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

พารามิเตอร์โซลูชัน Google Maps Platform

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

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

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

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

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

การใช้งานโควต้าจะแสดงเป็นกราฟในหน้าโควต้าใน 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 (พารามิเตอร์ไม่ถูกต้อง, ข้อผิดพลาดในการแยกวิเคราะห์คําขอ)) ไม่ใช้โควต้าและจะไม่แสดง

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

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

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

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

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

หน่วยโควต้า

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

API แพลตฟอร์ม Google แผนที่ หน่วยโควต้า
Maps
Maps SDK สำหรับ Android 1 พาโนรามา
Maps SDK สำหรับ iOS 1 พาโนรามา
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 รายการ
สถานที่
Places 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 หน้า
API พลังงานแสงอาทิตย์ คำขอ 1 รายการ

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

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

รายงานการเรียกเก็บเงินสำหรับการใช้ผลิตภัณฑ์ Google Maps Platform มีอยู่ใน Google Cloud Console (ดูการเรียกเก็บเงิน)

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

  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 1 รายการ) โปรดทราบว่าการใช้งานของคุณอาจใช้ API ที่เรียกเก็บเงินได้หลายรายการ ดังนั้นให้ปรับสมการตามที่จำเป็น อย่าลืมว่าเรามีเครดิต Google Maps Platform มูลค่า $200 USD ต่อเดือน ดังนั้น อย่าลืมนำมาคำนวณด้วย

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

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

  • 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 และค้นหาข้อมูล ให้ลองใช้การค้นหาตัวอย่างด้านล่าง ก่อนที่จะเรียกใช้การสืบค้นข้อมูลนี้ คุณต้องดำเนินการดังนี้

  • เปิดใช้การเรียกเก็บเงินและ การส่งออกการเรียกเก็บเงิน 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 4xx1 มี มี มี
NOT_FOUND (API แบบคงที่ของ Street View, ตำแหน่งทางภูมิศาสตร์ และถนน)
ZERO_RESULTS (Street View Static API)
404 4xx มี มี มี
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง)
MAX_ROUTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED,
ฯลฯ
200/400 4xx มี มี มี
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ไม่มีพารามิเตอร์ ข้อผิดพลาดในการแยกวิเคราะห์คําขอ) 200/400 4xx มี ไม่ได้ ไม่ได้
ส่งคำขอถูกปฏิเสธ 200/400/403 4xx1 มี ไม่ได้ ไม่ได้
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
DailyLimitExceeded,
RateLimitExceeded,
userRateLimitExceeded,
200/403
429
4xx1 มี ไม่ได้ ไม่ได้
ข้อผิดพลาดที่ไม่ทราบสาเหตุ 200/500,
503
5xx1 มี มี ไม่ได้
1 เพื่อปรับปรุงความสอดคล้องกันของการรายงานรหัสข้อผิดพลาด Google Maps Platform API จะย้ายข้อมูลดังต่อไปนี้ 1) จากรหัสการตอบกลับ HTTP คลาส 2xx เป็น 4xx สำหรับ สถานะ Maps API ได้แก่ DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - สถานะ, 2) จากคลาสโค้ดตอบกลับ HTTP 2xx เป็น 4xx สำหรับสถานะ Maps API: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, dailyLimitExceeded, rateLimitExceeded จากสถานะการตอบสนอง HTTP: 2xxuserRateLimitExceeded5xxUNKNOWN_ERROR คุณดูรหัสตอบกลับทั้งสองได้ในช่วงระยะเวลาการเปลี่ยน โค้ดตอบกลับที่แสดงผลในคำตอบของ Maps API ไม่มีการเปลี่ยนแปลง ยืนยันว่าการเพิ่มขึ้นของ 4xx และ/หรือ 5xx ในเมตริก Google Maps Platform เกี่ยวข้องกับการย้ายข้อมูลนี้ โดยตรวจสอบว่าโค้ดตอบกลับใดเพิ่มขึ้นในเครื่องมือสำรวจเมตริก (ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Cloud Monitoring สำหรับ Google Maps Platform)

รายงานการมีส่วนร่วม

ข้อมูลเชิงลึกทางธุรกิจ

Google Maps Platform ให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ผู้ใช้มีส่วนร่วมกับแผนที่ของคุณ ข้อมูลเชิงลึกเหล่านี้มีเมตริกการมีส่วนร่วมที่สำคัญ เช่น การดูบนแผนที่หรือการโต้ตอบกับจุดที่น่าสนใจ คุณสามารถวิเคราะห์ข้อมูลเชิงลึกเหล่านี้เพื่อค้นพบสถานที่ยอดนิยมสำหรับการโฆษณาและการตลาด หรือเพื่อเพิ่มประสิทธิภาพประสบการณ์ของผู้ใช้

ความสามารถในการรายงานข้อมูลเชิงลึกทางธุรกิจมีดังนี้

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

เมตริกการมีส่วนร่วมที่ใช้ได้มีดังนี้

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

ผู้ใช้จะดูข้อมูลเชิงลึกทางธุรกิจได้ในหน้าเมตริกใน Cloud Console ปัจจุบันมุมมองแผนที่มีให้บริการแก่นักพัฒนาซอฟต์แวร์ Maps JS API บางรายเพื่อทำการทดสอบเท่านั้น

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

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

การส่งออกข้อมูลเชิงลึกทางธุรกิจ

เมตริกข้อมูลเชิงลึกทางธุรกิจเป็นข้อมูลที่ไม่ระบุตัวบุคคล ดังนั้นจึงแสดงถึงแนวโน้มโดยรวมในการมีส่วนร่วมกับแผนที่เท่านั้น ระบบอาจปัดเศษจำนวนต่ำเป็น 0 และค่าที่ผิดปกติอาจลดลง

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

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

Locator Plus

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

รายงานการเปรียบเทียบช่วยให้คุณเปรียบเทียบข้อมูลของคุณกับข้อมูลอุตสาหกรรมที่รวบรวมไว้จากบริษัทอื่นๆ ที่แชร์ข้อมูลของตน การเปรียบเทียบนี้จะให้บริบทที่มีประโยชน์ ซึ่งช่วยให้คุณตั้งเป้าหมายที่มีความหมาย รับข้อมูลเชิงลึกเกี่ยวกับแนวโน้มของอุตสาหกรรม และดูว่าคุณมีประสิทธิภาพเพียงใดเมื่อเทียบกับคู่แข่ง

หากต้องการดูข้อมูลการเปรียบเทียบ ข้อมูลการมีส่วนร่วมของคุณจะรวมอยู่ในการเปรียบเทียบของ Google โดยไม่ระบุตัวตน หากต้องการเลือกไม่ใช้ทั้งการดูและการรวมข้อมูลการมีส่วนร่วมโดยไม่ระบุตัวตนในรายงานการเปรียบเทียบ ให้ส่งตั๋วสนับสนุน โดยทั่วไปคำขอแจ้งปัญหาจะได้รับการแก้ไขภายใน 3 วัน