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

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

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

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

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

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

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

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

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

เมตริกการใช้งานจะแสดงในตาราง (คําขอ ข้อผิดพลาด และเวลาในการตอบสนอง) และกราฟ (การเข้าชม ข้อผิดพลาด และเวลาในการตอบสนอง) วิธีการติดตาม

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

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

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

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

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

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

API การตรวจสอบ

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

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

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

  2. เลือกโปรเจ็กต์ หน้าแดชบอร์ดของ API และหน้าแดชบอร์ดบริการจะปรากฏขึ้น

    หากหน้าเว็บไม่ปรากฏขึ้น ให้เลือกปุ่มเมนู เมนู แล้วเลือก API & &; Services

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

หน้าภาพรวม Google Maps

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

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

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

  1. เปิดหน้า Google Maps Platform ใน Cloud Console:

    ไปที่หน้าแพลตฟอร์ม Google Maps

  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

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

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

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

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

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

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

ตัวกรองแพลตฟอร์มจะปรากฏขึ้นเมื่อเลือก API เพียงรายการเดียวเท่านั้น

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

  1. เปิดหน้า Google Maps Platform ใน Cloud Console:

    ไปที่หน้าแพลตฟอร์ม Google Maps

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

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

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

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

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

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

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

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

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

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

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

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

คําขอนี้เป็นคําขอที่เรียกเก็บเงินได้และจะใช้โควต้า
ข้อผิดพลาดที่ไม่รู้จัก 5xx ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ที่ระบุว่าไม่สามารถประมวลผลคําขอได้: ข้อผิดพลาดภายใน บริการมากเกินไป ไม่พร้อมใช้งาน หมดเวลา ฯลฯ

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

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

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

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, API ตําแหน่งทางภูมิศาสตร์ และ Elevation API) แต่มีข้อยกเว้นบางประการดังนี้

  • สําหรับ DISTANCE Matrix API หน่วยโควต้าคือองค์ประกอบ ที่เป็นคู่ต้นทาง-ปลายทาง
  • สําหรับ Maps JavaScript API หน่วยโควต้าคือการโหลดแผนที่
  • สําหรับ Maps SDK สําหรับ Android และ Maps SDK สําหรับ iOS หน่วยโควต้าคือคําขอ Street View/Panorama (โหลดแผนที่ไม่มีค่าใช้จ่ายและไม่ใช้โควต้า)

ภาพหน้าจอแสดงหน้า Maps และอันดับที่ 39 ใน Google Cloud Console โดยจะแสดงโควต้าตาม API โดยใช้ตัวเลือก จากนั้นแสดงการโหลดแผนที่ที่เกี่ยวข้องกับโควต้าที่กําหนดไว้สําหรับ API ที่เป็นปัญหา

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

  1. เปิดหน้า Google Maps Platform ใน Cloud Console:

    ไปที่หน้าแพลตฟอร์ม Google Maps

  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 ครั้ง
เส้นทาง
Directions API คําขอ 1 รายการ
Distance Matrix API 1 องค์ประกอบ (คู่ต้นทาง-ปลายทาง)
Roads API คําขอ 1 รายการ
สถานที่
Places 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 รายการที่เกี่ยวข้องกับ Google Maps Platform API ได้แก่ goog-maps-api-key-suffix (อักขระ 4 ตัวสุดท้ายของคีย์ API), goog-maps-platform-type (แพลตฟอร์มคือ Android, iOS, JavaScript หรือ webservice) และ goog-maps-channel (ค่าแชแนลตัวเลขที่ตั้งไว้จากการค้นหา API) ข้อมูลเพิ่มเติมเกี่ยวกับการกรองและการจัดกลุ่ม

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

ตรวจสอบและจํากัดการบริโภค

คุณสามารถทําสิ่งต่อไปนี้เพื่อช่วยวางแผนงบประมาณและควบคุมค่าใช้จ่ายได้

  • ตั้งค่าการแจ้งเตือนงบประมาณ เพื่อติดตามค่าใช้จ่ายที่เพิ่มขึ้นถึงจํานวนหนึ่งๆ การตั้งงบประมาณไม่อาจจํากัดการใช้ API แต่จะแจ้งให้คุณทราบเมื่อมียอดค่าใช้จ่ายใกล้ถึงจํานวนที่ระบุไว้เท่านั้น
  • กําหนดการใช้ API รายวัน เพื่อจัดการต้นทุนในการใช้ API ที่เรียกเก็บเงินได้ เพียงกําหนดวงเงินคําขอเป็นคําขอต่อวัน ใช้สมการง่ายๆ ในการกําหนดงบประมาณรายวันของคุณ โดยขึ้นอยู่กับจํานวนเงินที่คุณต้องการใช้จ่าย ตัวอย่างเช่น (ค่าใช้จ่ายรายเดือน /ราคาต่อ SKU แต่ละรายการ)/30 = คําขอต่อวันสูงสุด (สําหรับ API 1 รายการ) โปรดทราบว่าการใช้งานของคุณอาจใช้ API ที่เรียกเก็บเงินได้หลายรายการ ดังนั้นให้ปรับสมการตามต้องการ อย่าลืมว่าเรามีเครดิต Google Maps Platform มากถึง $200 USD ในแต่ละเดือน ดังนั้นอย่าลืมนําปัจจัยนี้มาพิจารณาด้วย

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

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

  • Geocoding Web Service API
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

ตรวจสอบการใช้งานช่องของคุณได้โดยตรงในรายงานการเรียกเก็บเงิน แชแนลจะแสดงเป็น ป้ายกํากับเป็นคีย์ goog-maps-channel

กรองตามป้ายกํากับ
ภาพที่ 4: กรองตาม SKU และแชแนล
วิธีกรองรายงานการเรียกเก็บเงินตาม SKU และช่องทาง
  1. ใช้ตัวกรองจัดกลุ่มตาม SKU
  2. เลือกเคอร์เซอร์ข้อความป้ายกํากับ
  3. เลือกเมนูแบบเลื่อนลงคีย์ แล้วเลือก goog-maps-channel
  4. เลือกเมนูแบบเลื่อนลงค่า แล้วเลือกช่องตัวเลขที่คุณต้องการกรอง

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

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

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

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

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

หากต้องการเริ่มต้นใช้งานการส่งออก BigQuery และการค้นหาข้อมูล ให้ลองใช้ตัวอย่างการค้นหาด้านล่าง ก่อนที่จะเรียกใช้การค้นหานี้ คุณต้องดําเนินการดังนี้

  • เปิดใช้การเรียกเก็บเงินและ การส่งออกการเรียกเก็บเงิน BigQuery ในบัญชี
  • รูปแบบตารางคือ PROJECT_IDDATASET_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

สถานะและรายงานการตอบกลับ

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

สถานะคําตอบ คลาสของโค้ดตอบกลับ HTTP
(2xx, 3xx, 4xx, 5xx)
คลาสการตอบกลับของ HTTP - รายงานการใช้งาน
(2xx, 3xx, 4xx, 5xx)
รายงานการใช้งาน รายงานโควต้า รายงานการเรียกเก็บเงิน
ตกลง 2xx,
3xx
2xx,
3xx
ใช่ ได้สิ ใช่
DATA_NOT_AVAILABLE,
ไม่พบ,
ZERO_RESULTS
2xx 2xx ใช่ ได้สิ ใช่
NOT_FOUND (Street View Static, Geolocation และ Roads API)
ZERO_RESULTS (Street View Static API)
4xx 4xx ใช่ ได้สิ ใช่
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง)
MAX_DIRECTIONTE_LENGTH_EXCEEDED,
MAX_WAYPOINTS_EXCEEDED
ฯลฯ
2xx/4xx 4xx ใช่ ได้สิ ใช่
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ขาดหายไป ข้อผิดพลาดในการแยกวิเคราะห์คําขอ) 2xx/4xx 4xx ใช่ ไม่ได้ ไม่ได้
คําขอถูกปฏิเสธ 2xx/4xx 4xx ใช่ ไม่ได้ ไม่ได้
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
DailyLimitExceeded,
RateLimitExceeded,
userRateLimitExceeded
2xx/4xx 4xx ใช่ ไม่ได้ ไม่ได้
ข้อผิดพลาดที่ไม่รู้จัก 2xx/5xx 5xx ใช่ ใช่ ไม่ได้

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

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

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

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