การรายงานใน Google Maps Platform มีชุดรายงานภาพการใช้งาน API พื้นฐาน โควต้า และข้อมูลการเรียกเก็บเงินที่กําหนดไว้ล่วงหน้าในคอนโซล Google Cloud ใช้รายงานเหล่านี้เพื่อดูจํานวนการเรียก API ที่คุณทํา ระยะใกล้ไกลที่คุณถึงโควต้าการใช้งาน API และตรวจสอบการใช้งานการเรียกเก็บเงินเมื่อเวลาผ่านไป
รายงานมีประเภทต่างๆ ดังนี้
- รายงานการใช้งาน: รายงานจํานวนคําขอที่โปรเจ็กต์ส่งไปยัง Google Maps Platform API โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์
- รายงานโควต้า: รายงานการใช้โควต้าในกราฟที่สามารถจัดกลุ่มคำขอต่อนาที ขีดจํากัดโควต้าปัจจุบันสําหรับ API ที่เลือกจะแสดงในตารางใต้กราฟการใช้โควต้า
- รายงานการเรียกเก็บเงิน: รายงานค่าใช้จ่ายตามช่วงเวลาเป็นแผนภูมิเส้นซ้อน ดูปริมาณการใช้โควต้าของเดือนปัจจุบัน ซึ่งรวมเครดิตเฉพาะการใช้งานที่ใช้ไป รวมถึงค่าใช้จ่ายทั้งหมดที่คาดการณ์ไว้ตลอดทั้งเดือนปัจจุบัน
- รายงานการมีส่วนร่วม: ให้ข้อมูลเชิงลึกทางธุรกิจเกี่ยวกับวิธีที่ผู้ใช้มีส่วนร่วมกับแอปแผนที่
ดูรายการสถานะการตอบกลับและรหัสการตอบกลับทั้งหมดที่กําหนดว่าคําขอจะปรากฏในรายงานการใช้งาน โควต้า และ/หรือการเรียกเก็บเงินหรือไม่ได้ที่สถานะการตอบกลับและรายงาน
ดูรายงานการใช้งาน โควต้า และการเรียกเก็บเงินของ Google Maps Platform โดยใช้ Cloud Console
รายงานการใช้งาน
การใช้งานจะอิงตามจํานวนคําขอที่โปรเจ็กต์ส่งไปยัง Google Maps Platform API โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์ คําขอรวมถึงคําขอที่ประสบความสําเร็จ คําขอที่ทําให้เกิดข้อผิดพลาดของเซิร์ฟเวอร์ และคําขอที่ทําให้เกิดข้อผิดพลาดของไคลเอ็นต์ ข้อมูลเข้าสู่ระบบประกอบด้วยคี API และรหัสไคลเอ็นต์ (สำหรับโปรเจ็กต์แพ็กเกจ Premium และโปรเจ็กต์แพ็กเกจ Premium ที่ย้ายข้อมูล) โปรดดูรายละเอียดที่ภาพรวมของแพ็กเกจพรีเมียมและข้อมูลเกี่ยวกับการใช้รหัสไคลเอ็นต์
เมตริกการใช้งานจะแสดงในตาราง (คําขอ ข้อผิดพลาด และเวลาในการตอบสนอง) และกราฟ (การเข้าชม ข้อผิดพลาด และเวลาในการตอบสนอง) เพื่อการติดตาม
API ทั้งหมด: คุณกรองและจัดกลุ่มเมตริกการใช้งานสําหรับ API ทั้งหมดได้ดังนี้
- กรองตามระยะเวลาและ API
- ดูการรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองที่จัดกลุ่มตามโค้ดตอบกลับ, API และข้อมูลเข้าสู่ระบบ
API ที่เฉพาะเจาะจง: คุณสามารถกรองและจัดกลุ่มเมตริกการใช้งานสําหรับ API ที่เฉพาะเจาะจงได้ดังนี้
- กรองตามระยะเวลา เวอร์ชัน API ข้อมูลเข้าสู่ระบบ และวิธีการ
- ดูปริมาณการเข้าถึง ข้อผิดพลาด และเวลาในการตอบสนองที่จัดกลุ่มตามรหัสการตอบกลับ วิธีการและเวอร์ชัน API รวมถึงข้อมูลเข้าสู่ระบบ
หน้าแดชบอร์ด API และบริการ
แดชบอร์ด API และบริการจะแสดงภาพรวมของเมตริกการใช้งาน API ทั้งหมดที่เปิดใช้สำหรับโปรเจ็กต์ของคุณ ซึ่งได้แก่ API ของ Google Maps Platform รวมถึง API และบริการอื่นๆ
หน้าแดชบอร์ดประกอบด้วยกราฟ 3 รายการและตาราง 1 ตาราง คุณกรองการใช้งานที่แสดงในกราฟและตารางได้โดยเลือกระยะเวลาตั้งแต่ 1 ชั่วโมงไปจนถึง 30 วันที่ผ่านมา
กราฟการรับส่งข้อมูลแสดงการใช้งานในการค้นหาต่อนาที (QPM) ต่อ 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 โดยทำดังนี้
- เลือกภาพรวมในเมนูด้านซ้าย
หน้า API และบริการของ Google Maps Platform
หน้าAPI และบริการของ Google Maps มีตารางกริดแสดง API, SDK และบริการอื่นๆ ที่พร้อมใช้งานสำหรับโปรเจ็กต์ ในแต่ละการ์ด คุณสามารถเปิดหรือปิดใช้บริการนั้นได้โดยเลือกเปิดใช้หรือปิดใช้ และเข้าถึงข้อมูลเข้าสู่ระบบ เมตริก และคู่มือผู้ใช้สําหรับ API ที่เปิดใช้ นอกจากนี้ คุณยังใช้ตัวกรองหน้าเว็บเพื่อดูบริการที่เปิดหรือปิดใช้และหมวดหมู่บริการอื่นๆ ได้ด้วย
วิธีเข้าถึงหน้า API และบริการของ Google Maps Platform
- เปิดหน้า 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 โดยทำดังนี้
- เลือกเมตริกในเมนูด้านซ้าย
การรายงานข้อมูลเข้าสู่ระบบ
คุณสามารถกรองและจัดกลุ่มเมตริกตามข้อมูลเข้าสู่ระบบที่ใช้โหลด API ได้
รูปแบบข้อมูลเข้าสู่ระบบ | ความหมาย |
---|---|
ชื่อคีย์ เช่น "คีย์แอปบนอุปกรณ์เคลื่อนที่" |
มีการใช้คีย์ API เพื่อโหลด API โดยใช้ ?key=... : คุณสามารถดูชื่อคีย์ในคอนโซล Maps Platform ในส่วนคีย์และข้อมูลเข้าสู่ระบบ |
หมายเลขโปรเจ็กต์ เช่น "project_number:123456" โดยที่ 123456 คือหมายเลขโปรเจ็กต์ |
หากเห็นข้อมูลเข้าสู่ระบบนี้ เป็นไปได้ 2 กรณีดังนี้
|
กราฟโค้ดตอบกลับ
กราฟการเข้าชมตามโค้ดตอบกลับและข้อผิดพลาดตามโค้ดตอบกลับจะแบ่งการใช้งานตามคลาสโค้ดตอบกลับ HTTP ตารางนี้แสดงการแมประหว่างสถานะการตอบกลับของ Google Maps Platform API กับคลาสโค้ดการตอบกลับ HTTP
สถานะ Maps API | คลาสโค้ดการตอบกลับ HTTP - รายงานการใช้งาน (2xx, 3xx, 4xx, 5xx) |
หมายเหตุ |
---|---|---|
ตกลง | 2xx | ตอบกลับสําเร็จ คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า |
ตกลง | 3xx | ตอบกลับสําเร็จ คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า ตัวอย่างเช่น คำขอวางรูปภาพที่ดำเนินการสำเร็จจะแสดงการเปลี่ยนเส้นทาง 302 ไปยังรูปภาพที่อ้างอิง |
DATA_NOT_AVAILABLE | 4xx(1) | การตอบกลับที่สำเร็จซึ่งระบุว่าไม่มีข้อมูลสำหรับสถานที่ที่ป้อน คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า |
ZERO_RESULTS | 4xx(1) | การตอบกลับที่สำเร็จไม่แสดงผลลัพธ์ คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า |
NOT_FOUND | 4xx(1) | สําหรับ Directions API ข้อความนี้บ่งชี้ว่าไม่สามารถจับคู่พิกัดภูมิศาสตร์ของสถานที่อย่างน้อย 1 แห่งที่ระบุไว้ในต้นทาง ปลายทาง หรือจุดแวะพักของคําขอ สําหรับ Places API ข้อความนี้บ่งชี้ว่าไม่พบสถานที่อ้างอิง (place_id) ในฐานข้อมูล Places คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า |
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED และอื่นๆ |
4xx | ข้อผิดพลาดที่เกิดจากค่าพารามิเตอร์ไม่ถูกต้อง ดูรายละเอียดเพิ่มเติมในการตอบกลับของ API คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า |
REQUEST_DENIED | 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 ข้อความนี้บ่งชี้ว่าระบบไม่สามารถจับคู่อินพุตกับถนนได้อย่างสมเหตุสมผล คำขอนี้เป็นแบบเรียกเก็บเงินได้และจะใช้โควต้า |
UNKNOWN_ERROR | 5xx | ข้อผิดพลาดเกี่ยวกับเซิร์ฟเวอร์ที่ระบุว่าดำเนินการตามคำขอไม่ได้ เช่น ข้อผิดพลาดภายใน เซิร์ฟเวอร์ทำงานหนักเกินไป ไม่พร้อมใช้งาน หมดเวลา และอื่นๆ |
1
เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด Google Maps Platform กำลังย้ายข้อมูล API ดังนี้
1) จากคลาสรหัสคำตอบ HTTP 2xx เป็น 4xx สำหรับสถานะ Maps API: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - status,
2) จากคลาสรหัสคำตอบ HTTP 2xx เป็น 4xx สำหรับสถานะ Maps API: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded ,
3) จากคลาสรหัสคำตอบ HTTP 2xx เป็น 5xx สำหรับสถานะ Maps API: UNKNOWN_ERROR
คุณจะดูทั้ง 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
(พารามิเตอร์ไม่ถูกต้อง ข้อผิดพลาดในการแยกวิเคราะห์คําขอ)) จะไม่ใช้โควต้าและจะไม่แสดง
หน่วยโควต้าคือคําขอสำหรับ API ส่วนใหญ่ของแพลตฟอร์ม Google Maps (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 หรือการโหลดภาพพาโนรามา การโหลดแผนที่ไม่มีค่าใช้จ่ายและไม่กินโควต้า
วิธีเข้าถึงหน้าโควต้าของ Google Maps Platform
- เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้
- เลือกโควต้าในเมนูด้านซ้าย
- เลือก API จากรายการแบบเลื่อนลงของ API
หน่วยโควต้า
ตารางนี้แสดงหน่วยโควต้าสำหรับ API ของ Google Maps Platform
Google Maps Platform API | หน่วยโควต้า |
---|---|
Maps | |
Maps SDK สำหรับ Android | พาโนรามา 1 รายการ |
Maps SDK สำหรับ iOS | พาโนรามา 1 รายการ |
Map Tiles API | คำขอ 1 รายการ |
Maps Aerial View API | คำขอ 1 รายการ |
Maps Static API | คำขอ 1 รายการ |
Maps JavaScript API | การโหลดแผนที่ 1 ครั้ง |
Street View Static API | คำขอ 1 รายการ |
Maps Embed API | การโหลดแผนที่ 1 ครั้ง |
เส้นทาง | |
Routes API (Compute Routes) | คำขอ 1 รายการ |
Routes API (Compute Route Matrix) | องค์ประกอบ 1 รายการ (คู่ต้นทาง-ปลายทาง) |
Directions API | คำขอ 1 รายการ |
Distance Matrix API | องค์ประกอบ 1 รายการ (คู่ต้นทาง-ปลายทาง) |
Roads API | คำขอ 1 รายการ |
Route Optimization API | คำขอ 1 รายการ |
Navigation SDK สำหรับ Android | ปลายทาง 1 แห่ง |
Navigation SDK สำหรับ iOS | ปลายทาง 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 หน้า |
Pollen API | คำขอ 1 รายการ |
Solar API | คำขอ 1 รายการ |
รายงานการเรียกเก็บเงิน
ดูรายงานการเรียกเก็บเงิน
รายงานการเรียกเก็บเงินสำหรับการใช้ผลิตภัณฑ์ Google Maps Platform ของคุณมีอยู่ใน Google Cloud Console ดูข้อมูลเพิ่มเติมได้ที่การเรียกเก็บเงิน
วิธีเข้าถึงรายงานการเรียกเก็บเงิน
- เปิดหน้าตัวเลือกโปรเจ็กต์ใน Cloud Console โดยทำดังนี้
- เลือกโปรเจ็กต์
- เลือกปุ่มเมนู แล้วเลือกการเรียกเก็บเงิน
- หากมีบัญชีสำหรับการเรียกเก็บเงินหลายบัญชี ให้เลือกไปที่บัญชีสำหรับการเรียกเก็บเงินที่ลิงก์เพื่อเปิดหน้าภาพรวมของบัญชีสำหรับการเรียกเก็บเงินที่ลิงก์
- ในเมนูด้านซ้าย ให้เลือกรายงานเพื่อเปิดหน้ารายงานการเรียกเก็บเงินสำหรับบัญชีสำหรับการเรียกเก็บเงินที่ลิงก์
วิธีอ่านแผนภูมิรายงานการเรียกเก็บเงิน
รายงานการเรียกเก็บเงินจะแสดงค่าใช้จ่ายตามช่วงเวลาเป็นแผนภูมิเส้นซ้อน มุมมองเริ่มต้นจะแสดงค่าใช้จ่ายเฉพาะการใช้งานรายวันของเดือนปัจจุบันที่จัดกลุ่มตามโปรเจ็กต์ (สำหรับผลิตภัณฑ์ทั้งหมด) ซึ่งรวมเครดิตเฉพาะการใช้งานที่ใช้อยู่ ตลอดจนค่าใช้จ่ายทั้งหมดที่คาดการณ์ไว้สำหรับทั้งเดือนปัจจุบัน แต่ละบรรทัดในแผนภูมิ (และแถวในตารางสรุป) จะสอดคล้องกับโปรเจ็กต์ โดยจัดอันดับจากมากไปน้อยตามต้นทุน ดูข้อมูลเพิ่มเติมเกี่ยวกับการตีความแผนภูมิในรายงานการเรียกเก็บเงิน
เคล็ดลับ: วิเคราะห์การใช้งานและต้นทุนต่อ SKU
หากต้องการทำความเข้าใจรายละเอียดของรูปแบบการกำหนดราคาแบบจ่ายตามที่ใช้จริงและผลกระทบต่อการใช้งานของคุณให้แม่นยำยิ่งขึ้น ให้ดูที่การใช้งานและต้นทุนตาม SKU
วิธีเปลี่ยนมุมมองรายงานให้แสดงรายการโฆษณาตาม SKU
- ในแผงทางด้านขวาของแผนภูมิ ให้ขยายตัวกรองจัดกลุ่มตาม
- เลือก 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 รายการ)
การติดตามการใช้งานต่อแชแนล
หากต้องการติดตามการใช้งานผ่านแชแนลตัวเลข คุณต้องเพิ่มพารามิเตอร์ "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
วิธีกรองรายงานการเรียกเก็บเงินตาม SKU และช่องทาง
- ใช้ตัวกรอง SKU จัดกลุ่มตาม
- เลือกเคอร์เซอร์ป้ายกำกับ
- เลือกเมนูแบบเลื่อนลงคีย์ แล้วเลือก goog-maps-channel
- เลือกเมนูแบบเลื่อนลงค่า แล้วเลือกแชแนลตัวเลขที่ต้องการกรอง
จัดกลุ่มตามคีย์ป้ายกํากับ goog-maps-channel เพื่อดูต้นทุนที่เกิดจากแต่ละแชแนล
เมื่อคุณใช้ข้อมูลการใช้งานแชแนลในคำขอแล้ว ระบบอาจมีความล่าช้าเล็กน้อย (สูงสุด 24 ชั่วโมง) ก่อนที่ข้อมูลจะแสดงในรายงานการเรียกเก็บเงิน
ส่งออกข้อมูลการเรียกเก็บเงินด้วย BigQuery
นอกจากนี้ คุณยัง ส่งออกข้อมูลการเรียกเก็บเงินไปยัง BigQuery ได้ด้วย
การส่งออกไปยัง BigQuery จะช่วยให้คุณส่งออกข้อมูลการเรียกเก็บเงินในระบบคลาวด์โดยละเอียด (เช่น ข้อมูลการใช้งานและค่าใช้จ่ายโดยประมาณ) ไปยัง ชุดข้อมูล BigQuery ที่คุณระบุได้โดยอัตโนมัติตลอดทั้งวัน จากนั้นคุณสามารถเข้าถึงข้อมูลการเรียกเก็บเงินจาก BigQuery เพื่อทำการวิเคราะห์อย่างละเอียด ซึ่งจะช่วยให้คุณเข้าใจแหล่งที่มาของการใช้งาน Google Maps Platform ได้ดียิ่งขึ้น
หากต้องการเริ่มต้นใช้งาน BigQuery Export และการค้นหาข้อมูล ให้ลองใช้ตัวอย่างการค้นหาด้านล่าง คุณต้องดำเนินการต่อไปนี้ก่อนเรียกใช้การค้นหานี้
- เปิดใช้การเรียกเก็บเงินและ การส่งออกการเรียกเก็บเงินไปยัง 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
- แก้ไขการตั้งค่าการเรียกเก็บเงินของโปรเจ็กต์
- ดูรายงานการเรียกเก็บเงินและแนวโน้มค่าใช้จ่าย
- ตั้งงบประมาณและการแจ้งเตือนงบประมาณ
- การกำหนดขีดจำกัดการใช้ 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, 404 |
4xx1 | ใช่ | ได้ | ใช่ |
INVALID_REQUEST (ค่าพารามิเตอร์ไม่ถูกต้อง), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, ฯลฯ |
200, 400 |
4xx | ใช่ | ได้ | ใช่ |
INVALID_REQUEST (พารามิเตอร์ไม่ถูกต้อง/ขาดหายไป ข้อผิดพลาดในการแยกวิเคราะห์คําขอ) | 200, 400 |
4xx | ใช่ | ไม่ได้ | ไม่ได้ |
REQUEST_DENIED | 200, 400, 403 |
4xx1 | ใช่ | ไม่ได้ | ไม่ได้ |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded |
200, 403, 429 |
4xx1 | ใช่ | ไม่ได้ | ไม่ได้ |
UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | ใช่ | ได้ | ไม่ได้ |
1
เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด Google Maps Platform กำลังย้ายข้อมูล API ดังนี้
1) จากคลาสรหัสคำตอบ HTTP 2xx เป็น 4xx สำหรับสถานะ Maps API: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - status,
2) จากคลาสรหัสคำตอบ HTTP 2xx เป็น 4xx สำหรับสถานะ Maps API: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded ,
3) จากคลาสรหัสคำตอบ HTTP 2xx เป็น 5xx สำหรับสถานะ Maps API: UNKNOWN_ERROR
คุณจะดูทั้ง 2 โค้ดตอบกลับได้ในช่วงเปลี่ยนผ่าน โค้ดตอบกลับที่แสดงในการตอบกลับของ Maps API จะไม่เปลี่ยนแปลง
ยืนยันว่าการเพิ่มขึ้นของ 4xx และ/หรือ 5xx ในเมตริก Google Maps Platform เกี่ยวข้องกับการย้ายข้อมูลนี้หรือไม่โดยตรวจสอบว่าโค้ดคำตอบใดที่เพิ่มขึ้นในเครื่องมือสำรวจเมตริก (ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้ Google Cloud Monitoring สําหรับ Google Maps Platform)
|
รายงานการมีส่วนร่วม
ข้อมูลเชิงลึกของธุรกิจ
Google Maps Platform ให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ผู้ใช้มีส่วนร่วมกับแผนที่ ข้อมูลเชิงลึกเหล่านี้รวมถึงเมตริกการมีส่วนร่วมที่สําคัญ เช่น การดูบนแผนที่หรือการโต้ตอบกับจุดที่น่าสนใจ คุณสามารถวิเคราะห์ข้อมูลเชิงลึกเหล่านี้เพื่อค้นหาสถานที่ยอดนิยมสําหรับการโฆษณาและการตลาด หรือเพื่อเพิ่มประสิทธิภาพประสบการณ์ของผู้ใช้
ความสามารถในการรายงานข้อมูลเชิงลึกทางธุรกิจมีดังนี้
- ดูภาพรวมข้อมูลเชิงลึกทางธุรกิจระดับสูงเพื่อดูเทรนด์สําคัญในข้อมูลเชิงลึกทางธุรกิจโดยย่อ
- เจาะลึกเพื่อวิเคราะห์เมตริกที่เฉพาะเจาะจงภายในคอนโซลเพื่อเจาะลึกการทำความเข้าใจเมตริกอย่างละเอียดยิ่งขึ้น
- การส่งออกเมตริกเป็น CSV เพื่อให้คุณวิเคราะห์ข้อมูลเชิงลึกทางธุรกิจในเครื่องมือวิเคราะห์ธุรกิจที่ชื่นชอบได้
เมตริกการมีส่วนร่วมที่ใช้ได้มีดังนี้
- การดูแผนที่: ติดตามการดูแผนที่ที่เกิดจากการเลื่อน ซูม หรือเอียง ระบบจะคำนวณยอดดูแผนที่ตามรหัสไปรษณีย์เป็นรายสัปดาห์ (วันอาทิตย์ถึงวันเสาร์ตามเวลาแปซิฟิก) ระบบจะเผยแพร่ข้อมูลใหม่ทุกสัปดาห์ในวันพุธแรกของระยะเวลาสังเกตการณ์
เจ้าของโปรเจ็กต์และผู้ใช้ที่มีบทบาทผู้ดูข้อมูลวิเคราะห์ของ Maps จะดูข้อมูลเชิงลึกทางธุรกิจได้ในหน้าเมตริกใน Cloud Console โปรเจ็กต์ต้องเปิดใช้ Maps JavaScript API
คุณสามารถวิเคราะห์เมตริกการมีส่วนร่วมได้โดยตรงในคอนโซลด้วยความสามารถในการกรองและจัดกลุ่มตามเพื่อเจาะลึกเมตริกอย่างละเอียด เช่น คุณอาจเลือกกรองตามภูมิภาคที่เฉพาะเจาะจงเพื่อดูแนวโน้มการดูแผนที่สำหรับรหัสไปรษณีย์ในภูมิภาคนั้นๆ เท่านั้น ในทางกลับกัน คุณอาจต้องการจัดกลุ่มตามภูมิภาคที่เฉพาะเจาะจงเพื่อรวบรวมการโต้ตอบภายในภูมิภาคนั้น
ผู้ใช้สามารถส่งออกชุดข้อมูลทั้งหมดหรือมุมมองที่กรองแล้วเป็น CSV เพื่อวิเคราะห์เพิ่มเติมในเครื่องมือวิเคราะห์ธุรกิจที่คุณชื่นชอบ คุณสามารถดาวน์โหลดข้อมูลย้อนหลังได้สูงสุด 90 วันพร้อมกัน และการดาวน์โหลดที่มีเซลล์มากกว่า 60,000 รายการจะถูกตัดให้สั้นลง การส่งออกข้อมูลมุมมองแผนที่ไปยัง CSV อาจใช้เวลา 2-3 นาที ทั้งนี้ขึ้นอยู่กับช่วงวันที่ที่เลือก
เมตริกข้อมูลเชิงลึกทางธุรกิจจะลบข้อมูลระบุตัวบุคคลออก ดังนั้นจึงแสดงเฉพาะแนวโน้มโดยรวมของการมีส่วนร่วมกับแผนที่ของคุณ ระบบอาจปัดเศษจํานวนต่ำเป็น 0 และลดการมีส่วนร่วมจากค่าเบี่ยงเบน
คุณควบคุมการเข้าถึงข้อมูลเชิงลึกทางธุรกิจสําหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ได้ในคอนโซล Google Cloud โดยใช้สิทธิ์ Maps Analytics เจ้าของโปรเจ็กต์จะได้รับสิทธิ์นี้โดยค่าเริ่มต้น และสามารถจัดสรรสิทธิ์เข้าถึงให้กับผู้ใช้รายอื่นได้ตามต้องการ
คุณไม่ควรใช้ข้อมูลเชิงลึกทางธุรกิจเพื่อประมาณค่าใช้จ่ายในการใช้งาน โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานในรายงานการใช้งาน