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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Monitoring 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 ข้อผิดพลาดของเซิร์ฟเวอร์ที่ระบุว่าไม่สามารถดําเนินการคําขอได้: ข้อผิดพลาดภายใน บริการมากเกินไป ไม่พร้อมใช้งาน หมดเวลา ฯลฯ
Google Maps Platform API กําลังย้ายข้อมูล: 1) จากคลาสรหัสการตอบสนอง HTTP 4xx 4xx<br class="ph-2-<"> class="ph-2-"><br class="ph"><br class="ph"><br class="ph"> คุณจะเห็นโค้ดตอบกลับทั้ง 2 แบบในระยะเวลาการเปลี่ยนแปลง โค้ดตอบกลับที่แสดงในการตอบกลับของ Maps API จะไม่มีการเปลี่ยนแปลง ยืนยันว่าการเพิ่มขึ้นของ 4xx และ/หรือ 5xx ในเมตริกของ Google Maps Platform เกี่ยวข้องกับการย้ายข้อมูลนี้โดยการตรวจสอบโค้ดตอบกลับที่เพิ่มขึ้นในเครื่องมือสํารวจเมตริก (ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Cloud Monitoring สําหรับ Google Maps Platform)

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

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

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

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

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

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

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

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

  • สําหรับ ระยะทางเมทริกซ์ 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 Platform หน่วยโควต้า
Maps
Maps SDK สำหรับ Android 1 พาโนรามา
Maps SDK สำหรับ iOS 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 รายการ
API การตรวจสอบที่อยู่ คําขอ 1 รายการ
Geocoding API คําขอ 1 รายการ
Geolocation API คําขอ 1 รายการ
Time Zone 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 รายการที่เกี่ยวข้องกับ API ของ Google Maps Platform คือ 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 (Street View Static, Geolocation และ Roads API),
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 ได้ ไม่ได้ ไม่ได้
คําขอถูกปฏิเสธ 400/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. คุณจะเห็นโค้ดตอบกลับทั้ง 2 แบบในระยะเวลาการเปลี่ยนแปลง โค้ดตอบกลับที่แสดงในการตอบกลับของ Maps API จะไม่มีการเปลี่ยนแปลง ยืนยันว่าการเพิ่มขึ้นของ 4xx และ/หรือ 5xx ในเมตริกของ Google Maps Platform เกี่ยวข้องกับการย้ายข้อมูลนี้โดยการตรวจสอบโค้ดตอบกลับที่เพิ่มขึ้นในเครื่องมือสํารวจเมตริก (ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Cloud Monitoring สําหรับ Google Maps Platform)

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

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

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

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