หน้านี้ได้รับการแปลโดย Cloud Translation API

การรายงาน 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 และบริการแดชบอร์ด

เปิดหน้าตัวเลือกโปรเจ็กต์ใน Cloud Console โดยทําดังนี้
หน้าตัวเลือกโปรเจ็กต์
เลือกโปรเจ็กต์ หน้าแดชบอร์ด API และบริการจะปรากฏขึ้น

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

สําหรับข้อมูลเพิ่มเติม โปรดดูการตรวจสอบการใช้งาน API

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

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

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

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

เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
ไปที่หน้า Google Maps Platform
เลือกภาพรวมในเมนูด้านซ้าย

หน้า Google Maps Platform API

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

apis

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

เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
ไปที่หน้า Google Maps Platform
เลือก API ในเมนูด้านซ้าย

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

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

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

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

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

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

ตัวกรองแพลตฟอร์มจะแสดงก็ต่อเมื่อเลือก API เพียงรายการเดียว

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

เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
ไปที่หน้า Google Maps Platform
ในเมนูด้านซ้าย ให้เลือกเมตริก

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

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

สถานะ Maps API	คลาสโค้ดตอบกลับ HTTP - รายงานการใช้งาน (2xx, 3xx, 4xx, 5xx)	หมายเหตุ
ตกลง	2xx	การตอบกลับเสร็จสมบูรณ์ นี่คือคําขอที่เรียกเก็บเงินได้และจะใช้โควต้า
ตกลง	3xx	การตอบกลับเสร็จสมบูรณ์ นี่คือคําขอที่เรียกเก็บเงินได้และจะใช้โควต้า ตัวอย่างเช่น คําขอรูปภาพสถานที่ที่ประสบความสําเร็จจะแสดงการเปลี่ยนเส้นทาง 302 ไปยังรูปภาพที่อ้างอิง
ไม่มีข้อมูล	4xx⁽¹⁾	การตอบสนองที่สําเร็จระบุว่าไม่มีข้อมูลสําหรับพื้นที่ป้อนข้อมูล นี่คือคําขอที่เรียกเก็บเงินได้และจะใช้โควต้า
ZERO_RESULTS	4xx⁽¹⁾	การตอบกลับที่สําเร็จไม่แสดงผลลัพธ์ นี่คือคําขอที่เรียกเก็บเงินได้และจะใช้โควต้า
ไม่พบ	4xx⁽¹⁾	สําหรับ 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

เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
ไปที่หน้า Google Maps Platform
เลือกโควต้าในเมนูด้านซ้าย
เลือก 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 (ดูการเรียกเก็บเงิน)

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

เปิดหน้าตัวเลือกโปรเจ็กต์ใน Cloud Console โดยทําดังนี้
หน้าตัวเลือกโปรเจ็กต์
เลือกโปรเจ็กต์
เลือกปุ่มเมนู จากนั้นเลือกการเรียกเก็บเงิน
หากมีบัญชีสําหรับการเรียกเก็บเงินหลายบัญชี ให้เลือกไปที่บัญชีสําหรับการเรียกเก็บเงินที่ลิงก์เพื่อเปิดหน้าภาพรวมของบัญชีสําหรับการเรียกเก็บเงินที่ลิงก์
ในเมนูด้านซ้าย ให้เลือกรายงานเพื่อเปิดหน้ารายงานการเรียกเก็บเงินของบัญชีสําหรับการเรียกเก็บเงินที่ลิงก์

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

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

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

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

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

รายงานการเรียกเก็บเงินที่จัดกลุ่มตาม SKU — **รูปที่ 2:** ตารางการเรียกเก็บเงินแสดงรายการโฆษณาการใช้งานและต้นทุนตาม SKU

ภาพหน้าจอของตัวกรองรายงานการเรียกเก็บเงิน — **รูปที่ 3:** ตัวกรองรายงานการเรียกเก็บเงิน

หากต้องการเปลี่ยนมุมมองรายงานเพื่อแสดงรายการโฆษณาตาม SKU ให้ทําดังนี้

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

ใช้ตัวกรอง SKU ตามจัดกลุ่มตาม
เลือกเคอร์เซอร์ข้อความป้ายกํากับ
เลือกเมนูแบบเลื่อนลงคีย์ แล้วเลือก goog-maps-channel
เลือกเมนูแบบเลื่อนลงค่า แล้วเลือกช่องตัวเลขที่ต้องการกรอง

จัดกลุ่มตามคีย์ป้ายกํากับ 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

หมายเหตุ: เมื่อสร้างชุดข้อมูลใหม่ ชุดข้อมูลจะปรากฏในอินเทอร์เฟซทันที แต่ตารางที่ค้นหายังไม่ปรากฏ ระบบจะสร้างตารางโดยอัตโนมัติหลังจากผ่านไป 2-3 ชั่วโมง จากนั้นจะใช้เวลาประมาณ 24 ชั่วโมงจึงจะดูข้อมูลได้ ชุดข้อมูล BigQuery จะแสดงเฉพาะข้อมูลการใช้งานและต้นทุนที่เกิดขึ้นจากวันที่ตั้งค่าการส่งออกการเรียกเก็บเงินและหลังจากนั้น กล่าวคือ ระบบไม่ได้เพิ่มข้อมูลสําหรับการเรียกเก็บเงินย้อนหลัง คุณจะไม่เห็นข้อมูลการเรียกเก็บเงินก่อนที่จะเปิดใช้การส่งออก BigQuery

  #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 ในรายงานการใช้งาน และระบุว่าคําขอที่เกี่ยวข้องปรากฏในรายงานการใช้งาน โควต้า และการเรียกเก็บเงินหรือไม่

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

รายงานการใช้งานในเมตริก 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	4xx¹	ได้	ได้	ได้
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	4xx¹	ได้	ไม่ได้	ไม่ได้
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, DailyLimitExceeded, RateLimitExceeded, userRateLimitExceeded	200/403 429	4xx¹	ได้	ไม่ได้	ไม่ได้
ข้อผิดพลาดที่ไม่รู้จัก	200/500 503	5xx¹	ได้	ได้	ไม่ได้
¹ เพื่อเป็นการปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด 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 และรายละเอียดสถานที่ รวมถึงอัตราการมีส่วนร่วมโดยรวม นอกจากนี้ หน้าแดชบอร์ดยังให้การเปรียบเทียบที่สําคัญเกี่ยวกับการเปรียบเทียบประสิทธิภาพของคุณกับผู้ค้าปลีกรายอื่นๆ

ไปที่ Locator Plus ใน Google Cloud Console
ไปที่ส่วนรายงานการมีส่วนร่วมของ Google Cloud Console เพื่อดูหน้าแดชบอร์ด Analytics

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

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