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

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

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

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

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

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

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

การใช้งานจะขึ้นอยู่กับจำนวนคำขอที่โปรเจ็กต์ของคุณส่งไปยัง Google Maps Platform APIs โดยใช้ข้อมูลเข้าสู่ระบบที่เชื่อมโยงกับโปรเจ็กต์ คำขอประกอบด้วยคำขอที่สำเร็จ คำขอที่ทำให้เกิดข้อผิดพลาดของเซิร์ฟเวอร์ และ คำขอที่ทำให้เกิดข้อผิดพลาดของไคลเอ็นต์ ข้อมูลเข้าสู่ระบบประกอบด้วยคีย์ API และรหัสไคลเอ็นต์ (สำหรับโปรเจ็กต์ในแพ็กเกจ Premium และโปรเจ็กต์ในแพ็กเกจ 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 การตรวจสอบ

วิธีเข้าถึงหน้าแดชบอร์ด 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. เลือกภาพรวมในเมนูด้านซ้าย

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

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

API

วิธีเข้าถึงหน้า API และบริการของ Google Maps Platform

  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 เดียวเท่านั้น

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

  1. เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้

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

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

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

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

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

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

  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 (เดิม) ข้อความนี้บ่งชี้ว่าระบบไม่สามารถเข้ารหัสพิกัดภูมิศาสตร์ของสถานที่ตั้งอย่างน้อย 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 สำหรับ

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

สำหรับ 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 ที่คุณสนใจ (เช่น การตอบกลับของ Geocodingหรือ การตอบกลับของ Directions)

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

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

Google จะรวมพารามิเตอร์การค้นหา solution_channel ไว้ในการเรียก API เพื่อรวบรวมข้อมูลเกี่ยวกับการใช้งานโค้ดตัวอย่าง เพื่อทำความเข้าใจการใช้งานและวิธีปรับปรุงโซลูชันของเรา

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

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

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

  1. เปิดหน้า Google Maps Platform ใน Cloud Console โดยทำดังนี้

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

  2. เลือกโควต้าในเมนูด้านซ้าย
  3. เลือก 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 (คำนวณเส้นทาง) คำขอ 1 รายการ
Routes API (คำนวณเมทริกซ์เส้นทาง) 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 รายการ
Places Aggregate 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 รายการ
Weather API คำขอ 1 รายการ

รายงานการเรียกเก็บเงิน

ดูรายงานการเรียกเก็บเงิน

รายงานการเรียกเก็บเงินสำหรับการใช้ผลิตภัณฑ์ Google Maps Platform จะอยู่ในคอนโซล Google Cloud ดูข้อมูลเพิ่มเติมได้ที่ การเรียกเก็บเงิน

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

  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 หนึ่งรายการ)

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

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

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

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

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

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

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

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

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

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

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

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

สถานะคำตอบและรายงาน

ตารางด้านล่างแสดงการแมประหว่างสถานะ 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 จะย้ายข้อมูลจากคลาสรหัสการตอบกลับ HTTP 2xx ไปยัง 4xx เพื่อปรับปรุงความสอดคล้องของการรายงานรหัสข้อผิดพลาด 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 และลดการมีส่วนร่วมจากค่าผิดปกติ

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

ไม่ควรใช้ข้อมูลเชิงลึกทางธุรกิจเพื่อประมาณค่าใช้จ่ายในการใช้งาน โปรดดูข้อมูลการใช้งานเพิ่มเติมในรายงานการใช้งาน