การรายงานใน Google Maps Platform มีชุดของภาพที่กำหนดไว้ล่วงหน้า รายงานพื้นฐานการใช้ API, โควต้า และข้อมูลสำหรับการเรียกเก็บเงินใน Google Cloud Console ใช้รายงานเหล่านี้เพื่อระบุจำนวน API การโทรที่คุณทำ ใกล้ที่จะถึงโควต้าการใช้งาน API แล้ว และตรวจสอบ การใช้งานการเรียกเก็บเงินของคุณในช่วงเวลาต่างๆ
ประเภทของรายงานมีดังนี้
- รายงานการใช้งาน: รายงานจำนวนคำขอที่โปรเจ็กต์ส่งไปยัง Google Maps Platform API โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์ของคุณ
- รายงานโควต้า: รายงานการใช้โควต้าในกราฟที่สามารถจัดกลุ่มเป็นคำขอต่อนาทีได้ ขีดจำกัดโควต้าปัจจุบันสำหรับ API ที่เลือกจะแสดงในตารางด้านล่างของกราฟการใช้งานโควต้า
- รายงานการเรียกเก็บเงิน: รายงานค่าใช้จ่ายในช่วงเวลาหนึ่งเป็นแผนภูมิเส้นแบบซ้อน ดู การใช้งานโควต้าของเดือนปัจจุบัน ซึ่งรวมเครดิตเฉพาะการใช้งานที่ใช้ไปแล้ว รวมถึงยอดรวม สำหรับทั้งเดือนปัจจุบัน
- รายงานการมีส่วนร่วม: ให้ข้อมูลเชิงลึกทางธุรกิจเกี่ยวกับวิธีที่ผู้ใช้มีส่วนร่วมกับแอปแผนที่ของคุณ
สำหรับรายการสถานะการตอบกลับทั้งหมดและรหัสการตอบกลับที่ระบุ คำขอปรากฏในการใช้งาน โควต้า และ/หรือรายงานการเรียกเก็บเงิน โปรดดู สถานะและรายงานการตอบกลับ
ดูรายงานการใช้งาน โควต้า และการเรียกเก็บเงินของแพลตฟอร์ม Google Maps โดยใช้ Cloud Console
รายงานการใช้งาน
การใช้งานจะอิงตามจำนวนคำขอที่โปรเจ็กต์ส่งไปยัง Google Maps Platform API โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับ คำขอรวมคำขอที่สำเร็จ คำขอที่ส่งผลให้เซิร์ฟเวอร์ และคำขอที่ทำให้เกิดข้อผิดพลาดของไคลเอ็นต์ ข้อมูลเข้าสู่ระบบ ได้แก่ คีย์ API และรหัสไคลเอ็นต์ (สำหรับโปรเจ็กต์แผนพรีเมียมและโปรเจ็กต์แผนพรีเมียมที่ย้ายข้อมูลแล้ว) โปรดดูรายละเอียดที่ภาพรวมแพ็กเกจพรีเมียมและ ข้อมูลเกี่ยวกับการใช้รหัสไคลเอ็นต์
เมตริกการใช้งานแสดงในตาราง (คำขอ ข้อผิดพลาด และเวลาในการตอบสนอง) และกราฟ (การจราจร ข้อผิดพลาด และเวลาในการตอบสนอง) สำหรับการติดตาม:
API ทั้งหมด: คุณสามารถกรองและจัดกลุ่มเมตริกการใช้งานสำหรับ API ทั้งหมดใน ด้วยวิธีต่อไปนี้
- กรองตามระยะเวลาและ API
- ดูการรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองที่จัดกลุ่มตามโค้ดตอบกลับ, API และ ข้อมูลเข้าสู่ระบบ
API ที่เฉพาะเจาะจง: คุณกรองและจัดกลุ่มเมตริกการใช้งานสำหรับ API ที่ต้องการได้ ด้วยวิธีเหล่านี้
- กรองตามระยะเวลา, เวอร์ชัน API, ข้อมูลเข้าสู่ระบบ และเมธอด
- ดูการรับส่งข้อมูล ข้อผิดพลาด และเวลาในการตอบสนองที่จัดกลุ่มตามโค้ดตอบกลับและเมธอด API และเวอร์ชัน และข้อมูลรับรอง
API และ หน้าแดชบอร์ดบริการ
API และ บริการต่างๆ แดชบอร์ด ให้ภาพรวมของเมตริกการใช้งานสำหรับ API ทั้งหมด เปิดใช้สำหรับโปรเจ็กต์ของคุณ: Google Maps Platform API รวมถึง API 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:
- เลือกภาพรวมในเมนูด้านซ้าย
Google Maps Platform API และ หน้าบริการ
Google Maps API และ บริการ มีตารางกริดของชิ้นส่วนที่แสดงถึง API, SDK และบริการอื่นๆ พร้อมใช้งานสำหรับโปรเจ็กต์ ภายในแต่ละการ์ด คุณจะเปิดหรือปิดใช้ บริการได้โดยเลือก เปิดใช้ หรือ ปิดใช้ แล้วคุณจะเข้าถึงข้อมูลเข้าสู่ระบบได้ ข้อมูล เมตริก และคู่มือผู้ใช้ 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:
- เลือกเมตริกในเมนูด้านซ้าย
การรายงานข้อมูลเข้าสู่ระบบ
คุณกรองและจัดกลุ่มเมตริกตามข้อมูลเข้าสู่ระบบที่ใช้โหลด 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
ข้อความนี้แสดงว่ามีการระบุสถานที่ตั้งอย่างน้อยหนึ่งแห่งใน
ไม่สามารถเข้ารหัสพิกัดภูมิศาสตร์ของต้นทาง ปลายทาง หรือจุดอ้างอิงของคำขอได้ สำหรับ Places API ข้อความนี้แสดงว่าตำแหน่งที่อ้างอิง (place_id) ไม่ใช่ ที่พบในฐานข้อมูลสถานที่ คำขอนี้เป็นคำขอที่เรียกเก็บเงินได้และจะใช้โควต้า |
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 - สถานะ
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 รายการในระหว่างการเปลี่ยน
6 เดือน โค้ดตอบกลับที่ปรากฏในคำตอบของ Maps API จะไม่เปลี่ยนแปลง
ยืนยันว่า4xx และ/หรือ5xx เพิ่มขึ้น
เมตริก Google Maps Platform
เกี่ยวข้องกับการย้ายข้อมูลนี้โดยตรวจสอบว่าโค้ดตอบกลับที่ตรงกันใดเพิ่มขึ้น
เครื่องมือสำรวจเมตริก
(ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้
Google Cloud Monitoring สำหรับ Google Maps Platform)
|
โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับรหัสสถานะและข้อความแสดงข้อผิดพลาดในคำตอบ เกี่ยวกับ API ที่คุณสนใจ (เช่น การตอบกลับการเข้ารหัสพิกัดภูมิศาสตร์ หรือ การตอบกลับเส้นทาง)
พารามิเตอร์โซลูชัน Google Maps Platform
Google Maps Platform มีโค้ดตัวอย่างมากมายเพื่อช่วยให้คุณเริ่มต้น และทำงานได้อย่างรวดเร็ว ตัวอย่างเช่น คุณสามารถใช้ เครื่องมือสร้างอย่างรวดเร็ว ใน Cloud Console ให้ทำตามโซลูชันอุตสาหกรรม คู่มือการติดตั้ง และเรียนรู้จาก Codelab
เพื่อทำความเข้าใจการใช้งานและวิธีปรับปรุงโซลูชันของเรา Google ได้รวม
พารามิเตอร์การค้นหา solution_channel
รายการ
ในการเรียก API เพื่อรวบรวมข้อมูลเกี่ยวกับการใช้โค้ดตัวอย่าง ดังนี้
- รวมพารามิเตอร์การค้นหา
solution_channel
ไว้แล้วโดยค่าเริ่มต้น ในโค้ดตัวอย่างโซลูชัน - พารามิเตอร์การค้นหาแสดงข้อมูลวิเคราะห์เกี่ยวกับการนำโซลูชันมาใช้ใน Google เพื่อปรับปรุงคุณภาพโซลูชันในอนาคต
- คุณเลือกไม่ใช้ได้โดยลบการค้นหา
solution_channel
และค่าจากโค้ดตัวอย่าง - คุณไม่จําเป็นต้องเก็บพารามิเตอร์นี้ไว้ กำลังนำคำค้นหาออก จะไม่ส่งผลต่อประสิทธิภาพ
- พารามิเตอร์การค้นหาจะใช้สำหรับการรายงานการใช้โค้ดตัวอย่างเท่านั้น
- พารามิเตอร์การค้นหาจะแยกจากข้อมูลวิเคราะห์เฉพาะ API และ การรายงาน ซึ่งหมายถึงการนำพารามิเตอร์ออกจากโค้ดตัวอย่างโซลูชัน ไม่ปิดใช้การรายงาน Maps JavaScript API ภายใน
รายงานโควต้า
โควต้าจะกำหนดขีดจำกัดของจำนวนคำขอที่โปรเจ็กต์ทำได้ไปยัง Google Maps Platform API เราจำกัดคำขอได้ 3 วิธีดังนี้ ต่อวัน ต่อนาที และต่อผู้ใช้ต่อนาที เฉพาะคำขอที่สำเร็จและ คำขอที่ทำให้เกิดข้อผิดพลาดของเซิร์ฟเวอร์จะนับรวมในโควต้า คำขอที่ การตรวจสอบสิทธิ์ที่ไม่สำเร็จจะไม่นับรวมในโควต้า
การใช้งานโควต้าจะแสดงเป็นกราฟในหน้าโควต้าใน Cloud Console และจัดกลุ่มเป็นคำขอต่อนาทีได้ ขีดจำกัดโควต้าปัจจุบันสำหรับ API ที่เลือกจะแสดงในตารางด้านล่างซึ่งมีการใช้งานโควต้า กราฟ
หากต้องการรับค่าโควต้าต่อนาทีสำหรับผลิตภัณฑ์ API ของ GMP ให้ใช้ เครื่องคิดเลข
หน้าโควต้าของ 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) แต่มีข้อยกเว้นบางประการ เช่น
- สำหรับ Distance Matrix API หน่วยโควต้าคือองค์ประกอบหนึ่ง ซึ่งเป็นคู่ต้นทาง-ปลายทาง
- สำหรับ Maps JavaScript API หน่วยโควต้าคือโหลดแผนที่
- สำหรับ Maps SDK สำหรับ Android และ Maps SDK สำหรับ iOS หน่วยโควต้าคือคำขอ Street View หรือพาโนรามา โหลด การโหลดแผนที่ไม่มีค่าใช้จ่ายและไม่ใช้โควต้า
วิธีเข้าถึงหน้าโควต้าแพลตฟอร์ม Google Maps
- เปิดหน้า Google Maps Platform ใน Cloud Console:
- เลือกโควต้าในเมนูด้านซ้าย
- เลือก API จากรายการ API แบบเลื่อนลง
หน่วยโควต้า
ตารางนี้แสดงหน่วยโควต้าสำหรับ Google Maps Platform API
API แพลตฟอร์ม Google Maps | หน่วยโควต้า |
---|---|
Maps | |
Maps SDK สำหรับ Android | 1 พาโนรามา |
Maps SDK สำหรับ iOS | 1 พาโนรามา |
Map Tiles API | 1 คำขอ |
API มุมมองทางอากาศของ Maps | 1 คำขอ |
Maps Static API | 1 คำขอ |
Maps JavaScript API | 1 โหลดแผนที่ |
Street View Static API | 1 คำขอ |
Maps Embed API | 1 โหลดแผนที่ |
เส้นทาง | |
Routes API (เส้นทางการประมวลผล) | 1 คำขอ |
Routes API (Compute Route Matrix) | 1 องค์ประกอบ (คู่ต้นทาง-ปลายทาง) |
Directions API | 1 คำขอ |
Distance Matrix API | 1 องค์ประกอบ (คู่ต้นทาง-ปลายทาง) |
Roads API | 1 คำขอ |
Route Optimization API | 1 คำขอ |
สถานที่ | |
Places API | 1 คำขอ |
Address Validation API | 1 คำขอ |
Geocoding API | 1 คำขอ |
Geolocation API | 1 คำขอ |
Time Zone API | 1 คำขอ |
สภาพแวดล้อม | |
API คุณภาพอากาศ (CurrentConditions และ HeatmapTile) | 1 คำขอ |
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 รายการ)
การติดตามการใช้งานต่อช่อง
ในการติดตามการใช้งานผ่านช่องทางตัวเลข คุณต้องเพิ่มช่อง "ช่อง" พารามิเตอร์ ในคำขอ 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
- API ของ Maps JavaScript
<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
- เลือกเครื่องหมาย Caret ของป้ายกำกับ
- เลือกเมนูแบบเลื่อนลงคีย์ แล้วเลือก 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
- แก้ไขการตั้งค่าการเรียกเก็บเงินของโปรเจ็กต์
- ดูรายงานการเรียกเก็บเงินและแนวโน้มค่าใช้จ่าย
- กำหนดงบประมาณและการแจ้งเตือนงบประมาณ
- การใช้ Capping 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 |
ใช่ | ได้ | ใช่ |
ไม่มีข้อมูล ไม่พบ 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 แหล่งข้อมูลที่ส่งออกแล้ว 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 - สถานะ
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 รายการในระหว่างการเปลี่ยน
6 เดือน โค้ดตอบกลับที่ปรากฏในคำตอบของ Maps API จะไม่เปลี่ยนแปลง
ยืนยันว่า4xx และ/หรือ5xx เพิ่มขึ้น
เมตริก Google Maps Platform
เกี่ยวข้องกับการย้ายข้อมูลนี้โดยตรวจสอบว่าโค้ดตอบกลับที่ตรงกันใดเพิ่มขึ้น
เครื่องมือสำรวจเมตริก
(ดูข้อมูลเพิ่มเติมเกี่ยวกับการใช้
Google Cloud Monitoring สำหรับ Google Maps Platform)
|
รายงานการมีส่วนร่วม
ข้อมูลเชิงลึกของธุรกิจ
Google Maps Platform ให้ข้อมูลเชิงลึกเกี่ยวกับวิธีที่ผู้ใช้มีส่วนร่วมกับแผนที่ของคุณ ข้อมูลเชิงลึกเหล่านี้ประกอบด้วยเมตริกการมีส่วนร่วมที่สำคัญ เช่น การดูบนแผนที่หรือการโต้ตอบกับจุดที่น่าสนใจ คุณสามารถวิเคราะห์ข้อมูลเชิงลึกเหล่านี้เพื่อเผยให้เห็นสถานที่ยอดนิยมสำหรับการโฆษณาและการตลาด หรือเพื่อเพิ่มประสิทธิภาพประสบการณ์ของผู้ใช้ได้
ความสามารถในการรายงานข้อมูลเชิงลึกทางธุรกิจมีดังนี้
- การดูภาพรวมข้อมูลเชิงลึกทางธุรกิจระดับสูงเพื่อดูแนวโน้มสำคัญในข้อมูลเชิงลึกทางธุรกิจได้อย่างรวดเร็ว
- การเจาะลึกเพื่อวิเคราะห์เมตริกที่เฉพาะเจาะจงภายในคอนโซลเพื่อเจาะลึกการทำความเข้าใจเมตริกอย่างละเอียดมากขึ้น
- การส่งออกเมตริกเป็น CSV เพื่อให้คุณวิเคราะห์ข้อมูลเชิงลึกทางธุรกิจในเครื่องมือวิเคราะห์ธุรกิจที่ชื่นชอบได้
เมตริกการมีส่วนร่วมที่ใช้ได้มีดังนี้
- มุมมองแผนที่: ติดตามมุมมองบนแผนที่ซึ่งเป็นผลจากการเลื่อน การซูม หรือการเอียง มุมมองแผนที่จะคำนวณตามรหัสไปรษณีย์เป็นรายสัปดาห์ (วันอาทิตย์ถึงวันเสาร์เวลาแปซิฟิก) ระบบจะเผยแพร่ข้อมูลใหม่ทุกสัปดาห์ในวันพุธแรกหลังระยะเวลาสังเกตการณ์
ผู้ใช้จะดูข้อมูลเชิงลึกทางธุรกิจได้ในหน้าเมตริกใน Cloud Console โปรเจ็กต์ต้อง เปิดใช้ Maps JavaScript API
คุณสามารถวิเคราะห์เมตริกการมีส่วนร่วมในคอนโซลได้โดยตรงด้วยฟังก์ชัน "ตัวกรอง" และ "จัดกลุ่มตาม" เพื่อเจาะลึกรายละเอียดของเมตริก ตัวอย่างเช่น คุณอาจเลือกที่จะกรองตามภูมิภาคหนึ่งๆ เพื่อดูแนวโน้มของมุมมองแผนที่สำหรับรหัสไปรษณีย์ในภูมิภาคนั้นๆ เท่านั้น ในทางกลับกัน คุณอาจต้องการจัดกลุ่มตามภูมิภาคเฉพาะเพื่อรวบรวมการโต้ตอบภายในภูมิภาคนั้นๆ
ผู้ใช้สามารถส่งออกทั้งชุดข้อมูลหรือมุมมองที่กรองแล้วไปยัง CSV เพื่อวิเคราะห์เพิ่มเติมในเครื่องมือวิเคราะห์ธุรกิจที่คุณชื่นชอบ คุณดาวน์โหลดได้สูงสุดครั้งละ 90 วัน และระบบจะตัดทอนการดาวน์โหลดที่เกิน 60,000 เซลล์ การส่งออกข้อมูลมุมมองแผนที่ไปยัง CSV อาจใช้เวลาสักครู่ ทั้งนี้ขึ้นอยู่กับช่วงเวลาที่เลือก
เมตริกข้อมูลเชิงลึกทางธุรกิจจะมีการลบข้อมูลระบุตัวบุคคล ดังนั้นจึงแสดงแนวโน้มโดยรวมในการมีส่วนร่วมกับแผนที่เท่านั้น จำนวนที่ต่ำอาจปัดเศษเป็น 0 และการมีส่วนร่วมกับค่าผิดปกติอาจลดลง
คุณสามารถควบคุมการเข้าถึงข้อมูลเชิงลึกทางธุรกิจสําหรับโปรเจ็กต์ที่อยู่ในระบบคลาวด์ใน Google Cloud Console โดยใช้สิทธิ์ Maps Analytics เจ้าของโปรเจ็กต์จะได้รับสิทธิ์นี้โดยค่าเริ่มต้น และสามารถจัดสรรสิทธิ์เข้าถึงให้กับผู้ใช้อื่นๆ ได้ตามต้องการ
ไม่ควรใช้ข้อมูลเชิงลึกทางธุรกิจเพื่อประเมินต้นทุนการใช้งาน โปรดดูที่รายงานการใช้งานสำหรับข้อมูลเพิ่มเติมเกี่ยวกับการใช้งาน
Locator Plus
สําหรับผู้ใช้ Locator Plus แดชบอร์ดข้อมูลวิเคราะห์จะช่วยวิเคราะห์และสร้าง ข้อมูลเชิงลึกจากข้อมูลของคุณ ซึ่งจะให้ภาพที่ชัดเจนว่าผู้เลือกซื้อของคุณได้ดีเพียงใด กับเครื่องระบุตำแหน่งร้าน คุณสามารถวัดประสิทธิภาพได้ในแต่ละสัปดาห์ รวมทั้งจำนวนยอดดู จำนวนการโต้ตอบกับ Search และ รายละเอียดสถานที่และอัตราการมีส่วนร่วมโดยรวม นอกจากนี้ แดชบอร์ด ให้ตัวเปรียบเทียบที่สำคัญกับคุณ ว่าการดำเนินการของคุณเป็นอย่างไรเมื่อเทียบกับ ผู้ค้าปลีกรายอื่นๆ
- ไปที่ Locator Plus ใน คอนโซล Google Cloud
- ไปที่ส่วนรายงานการมีส่วนร่วมของ Google Cloud Console เพื่อดูแดชบอร์ดข้อมูลวิเคราะห์
รายงานการเปรียบเทียบช่วยให้คุณสามารถเปรียบเทียบข้อมูลของคุณกับ ข้อมูลอุตสาหกรรมจากบริษัทอื่นๆ ที่แชร์ข้อมูลของตน การเปรียบเทียบ ให้บริบทที่มีคุณค่า ซึ่งจะช่วยคุณตั้งเป้าหมายที่มีความหมาย เพิ่ม ข้อมูลเชิงลึกเกี่ยวกับแนวโน้มอุตสาหกรรม และดูว่าผลงานของคุณเป็นอย่างไรเมื่อเทียบกับ คู่แข่งของคุณ
หากต้องการดูข้อมูลการเปรียบเทียบ ระบบจะรวมข้อมูลการมีส่วนร่วมโดยไม่ระบุตัวตน ในเกณฑ์มาตรฐานของ Google หากต้องการเลือกไม่รับทั้งการดูและการรวม ข้อมูลการมีส่วนร่วมแบบไม่ระบุตัวตนในรายงานการเปรียบเทียบ คำขอแจ้งปัญหา โดยทั่วไปคำขอแจ้งปัญหาจะได้รับการแก้ไขภายใน 3 วัน