การรายงานใน 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
จะย้ายข้อมูล API ต่างๆ ดังนี้
1) จากคลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx
สำหรับสถานะ Maps API ได้แก่ DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - สถานะ,
2) จากคลาสรหัสการตอบกลับ HTTP 2xx เป็น 4xx สำหรับ
สถานะ Maps API: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded , รหัส dailyLimitExceeded , {13/ รหัส dailyLimitExceeded , 2xx )rateLimitExceeded userRateLimitExceeded 5xx 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 ทำตามคำแนะนำการใช้งานโซลูชันอุตสาหกรรม และเรียนรู้จาก 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
(พารามิเตอร์ไม่ถูกต้อง ข้อผิดพลาดในการแยกวิเคราะห์คําขอ)) จะไม่ใช้โควต้าและจะไม่แสดง
หน่วยโควต้าคือคําขอสำหรับ 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 ในคอนโซลระบบคลาวด์
- เลือกโควต้าในเมนูด้านซ้าย
- เลือก API จากรายการ API แบบเลื่อนลง
หน่วยโควต้า
ตารางนี้แสดงหน่วยโควต้าสำหรับ Google Maps Platform API
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 คำขอ |
สภาพแวดล้อม | |
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 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 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
- สร้าง แก้ไข หรือปิดบัญชีสำหรับการเรียกเก็บเงินใน 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 จะดูข้อมูลเชิงลึกทางธุรกิจได้ในหน้าเมตริกในคอนโซลระบบคลาวด์ โปรเจ็กต์ต้องเปิดใช้ Maps JavaScript API
คุณสามารถวิเคราะห์เมตริกการมีส่วนร่วมได้โดยตรงในคอนโซลด้วยความสามารถในการกรองและจัดกลุ่มตามเพื่อเจาะลึกเมตริกอย่างละเอียด ตัวอย่างเช่น คุณอาจเลือกที่จะกรองตามภูมิภาคหนึ่งๆ เพื่อดูแนวโน้มของมุมมองแผนที่สำหรับรหัสไปรษณีย์ในภูมิภาคนั้นๆ เท่านั้น ในทางกลับกัน คุณอาจต้องการจัดกลุ่มตามภูมิภาคที่เฉพาะเจาะจงเพื่อรวบรวมการโต้ตอบภายในภูมิภาคนั้น
ผู้ใช้สามารถส่งออกชุดข้อมูลทั้งหมดหรือมุมมองที่กรองแล้วเป็น CSV เพื่อวิเคราะห์เพิ่มเติมในเครื่องมือวิเคราะห์ธุรกิจที่คุณชื่นชอบ คุณสามารถดาวน์โหลดข้อมูลย้อนหลังได้สูงสุด 90 วันพร้อมกัน และการดาวน์โหลดที่มีเซลล์มากกว่า 60,000 รายการจะถูกตัดให้สั้นลง การส่งออกข้อมูลมุมมองแผนที่ไปยัง CSV อาจใช้เวลาสักครู่ ทั้งนี้ขึ้นอยู่กับช่วงเวลาที่เลือก
เมตริกข้อมูลเชิงลึกทางธุรกิจจะลบข้อมูลระบุตัวบุคคลออก ดังนั้นจึงแสดงเฉพาะแนวโน้มโดยรวมของการมีส่วนร่วมกับแผนที่ของคุณ ระบบอาจปัดเศษจํานวนต่ำเป็น 0 และลดการมีส่วนร่วมจากค่าเบี่ยงเบนมาก
คุณควบคุมการเข้าถึงข้อมูลเชิงลึกทางธุรกิจสําหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ได้ในคอนโซล Google Cloud โดยใช้สิทธิ์ Maps Analytics เจ้าของโปรเจ็กต์จะได้รับสิทธิ์นี้โดยค่าเริ่มต้นและสามารถจัดสรรสิทธิ์เข้าถึงให้กับผู้ใช้รายอื่นได้ตามต้องการ
คุณไม่ควรใช้ข้อมูลเชิงลึกทางธุรกิจเพื่อประมาณค่าใช้จ่ายในการใช้งาน โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้งานในรายงานการใช้งาน