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

การรายงานใน 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 การตรวจสอบ

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

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

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

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

    หากหน้าเว็บไม่ปรากฏ ให้เลือกปุ่มเมนู เมนู แล้วเลือก API และ บริการ

สำหรับข้อมูลเพิ่มเติม โปรดดูการตรวจสอบการใช้ API ของคุณ

หน้าภาพรวมของ Google Maps

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

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

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

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

    ไปที่หน้า Google Maps Platform

  2. เลือกภาพรวมในเมนูด้านซ้าย

Google Maps Platform API และ หน้าบริการ

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

API

เพื่อเข้าถึง Google Maps Platform API และ หน้าบริการ:

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

    ไปที่หน้า Google Maps Platform

  2. เลือก API และในเมนูทางด้านซ้าย บริการ

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

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

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

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

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

รูปภาพต่อไปนี้แสดงตัวกรองแพลตฟอร์มและโดเมนสำหรับ API เดียวเมื่อ คุณเลือกการจัดกลุ่มตามแพลตฟอร์มและโดเมนในรายการแบบเลื่อนลงจัดกลุ่มตามแล้ว ดังนี้

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

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

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

    ไปที่หน้า Google Maps Platform

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

การรายงานข้อมูลเข้าสู่ระบบ

คุณกรองและจัดกลุ่มเมตริกตามข้อมูลเข้าสู่ระบบที่ใช้โหลด API

รูปแบบข้อมูลเข้าสู่ระบบ ความหมาย
ชื่อคีย์
เช่น "คีย์แอปบนอุปกรณ์เคลื่อนที่"
มีการใช้คีย์ API เพื่อโหลด API โดยใช้ ?key=...: คุณดูชื่อคีย์ได้ในแพลตฟอร์ม Maps คอนโซลใต้คีย์และ ข้อมูลเข้าสู่ระบบ
หมายเลขโปรเจ็กต์
เช่น "project_number:123456" โดยที่ 123456 คือหมายเลขโปรเจ็กต์
หากคุณเห็นการรับรองนี้ที่เป็นไปได้ 2 อย่างคือ
  1. สำหรับ API ที่ยอมรับรหัสไคลเอ็นต์ของ Maps Platform: A มีการใช้รหัสไคลเอ็นต์ของแพลตฟอร์ม Maps เพื่อโหลด API ตัวอย่างเช่น ด้วย &client=gme-_mycompany_

    API เหล่านี้ยอมรับรหัสไคลเอ็นต์ ได้แก่ Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API, ระยะทาง Matrix API, Geocoding API, Time Zone API สำหรับข้อมูลเพิ่มเติม โปรดดู การจัดการรหัสไคลเอ็นต์ของแผนพรีเมียม

  2. สำหรับ API ที่ยอมรับ OAuth: โหลด API แล้ว ใช้ OAuth โดยไม่มีคีย์ API

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

กราฟแยกการรับส่งข้อมูลตามโค้ดตอบกลับและข้อผิดพลาดตามโค้ดตอบกลับ การใช้งานตามคลาสของโค้ดตอบกลับ 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 ให้ทำตามโซลูชันอุตสาหกรรม คู่มือการติดตั้ง และเรียนรู้จาก codelabs

เพื่อทำความเข้าใจการใช้งานและวิธีปรับปรุงโซลูชันของเรา 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 หรือพาโนรามา โหลด การโหลดแผนที่ไม่มีค่าใช้จ่ายและไม่ใช้โควต้า

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

วิธีเข้าถึงหน้าโควต้าแพลตฟอร์ม Google Maps

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

    ไปที่หน้า Google Maps Platform

  2. เลือกโควต้าในเมนูด้านซ้าย
  3. เลือก 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 สำหรับข้อมูลเพิ่มเติม โปรดดู การเรียกเก็บเงิน

วิธีเข้าถึงรายงานการเรียกเก็บเงิน

  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 หรือบริการเว็บ) และ 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

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

จัดกลุ่มตามคีย์ป้ายกำกับ 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

แพลตฟอร์ม Google Maps

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

ตารางด้านล่างแสดงการแมประหว่างสถานะ 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 และ รายละเอียดสถานที่และอัตราการมีส่วนร่วมโดยรวม นอกจากนี้ แดชบอร์ด ให้ตัวเปรียบเทียบที่สำคัญกับคุณ ว่าการดำเนินการของคุณเป็นอย่างไรเมื่อเทียบกับ ผู้ค้าปลีกรายอื่นๆ

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

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