การรายงานใน 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 และบริการที่เปิดใช้แล้วใต้กราฟ คําขอคือจํานวนคําขอ (สําหรับระยะเวลาที่เลือก) ข้อผิดพลาด คือจํานวนคําขอเหล่านี้ซึ่งทําให้เกิดข้อผิดพลาด เวลาในการตอบสนอง (เวลาในการตอบสนองปานกลางและเปอร์เซ็นไทล์) คือเวลาในการตอบสนองสําหรับคําขอเหล่านี้
วิธีเข้าถึงหน้าแดชบอร์ด API และบริการแดชบอร์ด
- เปิดหน้าตัวเลือกโปรเจ็กต์ใน Cloud Console โดยทําดังนี้
- เลือกโปรเจ็กต์ หน้าแดชบอร์ด API และบริการจะปรากฏขึ้น
หากหน้าเว็บไม่ปรากฏ ให้เลือกปุ่มเมนูแล้วเลือก API และบริการ
สําหรับข้อมูลเพิ่มเติม โปรดดูการตรวจสอบการใช้งาน API
หน้าภาพรวมของ Google Maps
หน้าภาพรวมของ Google Maps มี API ที่แสดงตารางและคําขอการใช้งานในช่วง 30 วันที่ผ่านมา คําขอตาม API จะแสดงในรูปแบบกราฟด้วย กราฟการเรียกเก็บเงินจะแสดงการเรียกเก็บเงินปัจจุบันและการใช้งานทั้งหมดในช่วง 3 เดือนที่ผ่านมา
วิธีเข้าถึงหน้าภาพรวม Google Maps Platform
- เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
- เลือกภาพรวมในเมนูด้านซ้าย
หน้า Google Maps Platform API
หน้า API ของ Google Maps มี 2 ตาราง ตาราง API ที่เปิดใช้แล้วจะแสดงจํานวนคําขอ จํานวนข้อผิดพลาด และเวลาในการตอบสนองโดยเฉลี่ยสําหรับ API ที่เปิดใช้แต่ละรายการในช่วง 30 วันที่ผ่านมา ตาราง API เพิ่มเติมจะแสดง API ที่ไม่ได้เปิดใช้
วิธีเข้าถึงหน้า Google Maps Platform API
- เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
- เลือก API ในเมนูด้านซ้าย
หน้าเมตริกของ Google Maps
หน้าเมตริกของ Google Maps แสดงกราฟ 3 อย่าง ได้แก่ การเข้าชม ข้อผิดพลาด และเวลาในการตอบสนองค่ามัธยฐาน คุณสามารถจัดกลุ่มข้อมูลการใช้งานในกราฟตามคลาสโค้ดตอบกลับ, API, วิธี API, ข้อมูลเข้าสู่ระบบ, แพลตฟอร์ม และโดเมน
หน้าเมตริกที่อยู่ใต้กราฟจะมีตาราง API ที่แสดงคําขอ ข้อผิดพลาด และเวลาในการตอบสนองของ API ที่คุณเลือกไว้
การใช้เมนู API แบบเลื่อนลงที่ด้านบน และตัวเลือกการจัดกลุ่มและการกรองในแผงด้านขวาช่วยให้คุณจัดกลุ่มและกรองเมตริกการใช้งานที่แสดงได้โดยเลือก API ที่เฉพาะเจาะจงหรือหลายรายการ, ข้อมูลเข้าสู่ระบบ, คลาสโค้ดตอบกลับ, ประเภทแพลตฟอร์ม และ/หรือโดเมน คุณยังเลือกระยะเวลา (ตั้งแต่ 1 ชั่วโมงถึง 30 วันที่ผ่านมา) และแบบละเอียด (ต่อวินาทีหรือวัน) สําหรับเมตริกการใช้งานที่แสดงอยู่ได้ด้วย
รูปภาพต่อไปนี้แสดงตัวกรองแพลตฟอร์มและโดเมนสําหรับ API เดียวเมื่อจัดกลุ่มตามแพลตฟอร์มและโดเมนในรายการแบบเลื่อนลงจัดกลุ่มตาม
วิธีเข้าถึงหน้าเมตริก Google Maps Platform API
- เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
- ในเมนูด้านซ้าย ให้เลือกเมตริก
กราฟโค้ดตอบกลับ
กราฟการเข้าชมตามโค้ดตอบกลับและข้อผิดพลาดตามโค้ดตอบกลับจะแบ่งการใช้งานตามคลาสโค้ดตอบกลับ 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/การโหลดพาโนรามา (โหลดแผนที่ได้โดยไม่มีค่าใช้จ่ายและไม่เปลืองโควต้า)
วิธีเข้าถึงหน้าโควต้าของ Google Maps Platform
- เปิดหน้า Google Maps Platform ใน Cloud Console โดยทําดังนี้
- เลือกโควต้าในเมนูด้านซ้าย
- เลือก 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 โดยทําดังนี้
- เลือกโปรเจ็กต์
- เลือกปุ่มเมนู
จากนั้นเลือกการเรียกเก็บเงิน
- หากมีบัญชีสําหรับการเรียกเก็บเงินหลายบัญชี ให้เลือกไปที่บัญชีสําหรับการเรียกเก็บเงินที่ลิงก์เพื่อเปิดหน้าภาพรวมของบัญชีสําหรับการเรียกเก็บเงินที่ลิงก์
- ในเมนูด้านซ้าย ให้เลือกรายงานเพื่อเปิดหน้ารายงานการเรียกเก็บเงินของบัญชีสําหรับการเรียกเก็บเงินที่ลิงก์
วิธีอ่านแผนภูมิรายงานการเรียกเก็บเงิน
รายงานการเรียกเก็บเงินจะพล็อตต้นทุนเมื่อเวลาผ่านไปเป็นแผนภูมิเส้นแบบซ้อน มุมมองเริ่มต้นแสดงค่าใช้จ่ายเฉพาะการใช้งานรายวันของเดือนปัจจุบันที่จัดกลุ่มตามโปรเจ็กต์ (สําหรับผลิตภัณฑ์ทั้งหมด) โดยรวมเครดิตเฉพาะการใช้งานที่ใช้ รวมถึงค่าใช้จ่ายที่คาดการณ์สําหรับทั้งเดือนปัจจุบัน แต่ละบรรทัดในแผนภูมิ (และแถวในตารางสรุป) จะสอดคล้องกับโปรเจ็กต์ โดยจัดอันดับจากใหญ่ที่สุดไปเล็กสุดโดยใช้ต้นทุน ดูข้อมูลเพิ่มเติมเกี่ยวกับการตีความแผนภูมิรายงานการเรียกเก็บเงิน

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


หากต้องการเปลี่ยนมุมมองรายงานเพื่อแสดงรายการโฆษณาตาม 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

หากต้องการกรองรายงานการเรียกเก็บเงินตาม 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
#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:
- สร้าง แก้ไข หรือปิดบัญชีสําหรับการเรียกเก็บเงินใน Cloud
- แก้ไขการตั้งค่าการเรียกเก็บเงินของโปรเจ็กต์
- ดูรายงานการเรียกเก็บเงินและแนวโน้มค่าใช้จ่าย
- ตั้งงบประมาณและการแจ้งเตือนงบประมาณ
- การใช้ API สูงสุด
- การเรียกเก็บเงินของ Google Maps Platform
- คู่มือการเพิ่มประสิทธิภาพ
- แนวทางปฏิบัติแนะนําสําหรับคีย์ API
สถานะและรายงานการตอบกลับ
ตารางด้านล่างแสดงการจับคู่ระหว่างสถานะ 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 และรายละเอียดสถานที่ รวมถึงอัตราการมีส่วนร่วมโดยรวม นอกจากนี้ หน้าแดชบอร์ดยังให้การเปรียบเทียบที่สําคัญเกี่ยวกับการเปรียบเทียบประสิทธิภาพของคุณกับผู้ค้าปลีกรายอื่นๆ
- ไปที่ Locator Plus ใน Google Cloud Console
- ไปที่ส่วนรายงานการมีส่วนร่วมของ Google Cloud Console เพื่อดูหน้าแดชบอร์ด Analytics
รายงานการเปรียบเทียบช่วยให้คุณเปรียบเทียบข้อมูลกับข้อมูลอุตสาหกรรมแบบรวมจากบริษัทอื่นๆ ที่แชร์ข้อมูลของบริษัทได้ การเปรียบเทียบจะให้บริบทที่เป็นประโยชน์ ช่วยให้คุณกําหนดเป้าหมายที่มีความหมาย รับข้อมูลเชิงลึกเกี่ยวกับแนวโน้มอุตสาหกรรม และดูว่าคุณมีประสิทธิภาพเป็นอย่างไรเมื่อเทียบกับคู่แข่ง
หากต้องการดูข้อมูลการเปรียบเทียบ ระบบจะรวมข้อมูลการมีส่วนร่วมของคุณไว้แบบไม่ระบุตัวตนในการเปรียบเทียบ Google หากต้องการเลือกไม่ใช้ทั้งการดูและรวมข้อมูลการมีส่วนร่วมโดยไม่ระบุตัวตนในรายงานการเปรียบเทียบ ให้ยื่นตั๋วสนับสนุน โดยทั่วไป คําขอแจ้งปัญหาจะได้รับการแก้ไขภายใน 3 วัน