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

การรายงานใน 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 และบริการที่เปิดใช้ คำขอคือจำนวนคำขอ (สำหรับระยะเวลาที่เลือก) ข้อผิดพลาดคือจํานวนคําขอเหล่านี้ที่ทําให้เกิดข้อผิดพลาด เวลาในการตอบสนอง (เวลาในการตอบสนองระดับกลางและเปอร์เซ็นไทล์) คือเวลาในการตอบสนองของคําขอเหล่านี้

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

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

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

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

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

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

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

รูปแบบข้อมูลเข้าสู่ระบบ ความหมาย
ชื่อคีย์
เช่น "คีย์แอปบนอุปกรณ์เคลื่อนที่"
มีการใช้คีย์ API เพื่อโหลด API โดยใช้ ?key=...: คุณดูชื่อคีย์ได้ในคอนโซล Maps Platform ในส่วนคีย์และข้อมูลเข้าสู่ระบบ
หมายเลขโปรเจ็กต์
เช่น "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 ดูข้อมูลเพิ่มเติมได้ที่ การจัดการรหัสไคลเอ็นต์ของแพ็กเกจพรีเมียม

  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 สําหรับ 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)rateLimitExceededuserRateLimitExceeded5xxUNKNOWN_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 หรือการโหลดภาพพาโนรามา การโหลดแผนที่ไม่มีค่าใช้จ่ายและไม่ใช้โควต้า

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

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

  1. เปิดหน้า Google Maps Platform ในคอนโซลระบบคลาวด์

    ไปที่หน้า 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 (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 ดูข้อมูลเพิ่มเติมได้ที่การเรียกเก็บเงิน

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

  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 รายการ)

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

หากต้องการติดตามการใช้งานผ่านแชแนลตัวเลข คุณต้องเพิ่มพารามิเตอร์ "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

กรองตามป้ายกำกับ
รูปที่ 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 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

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

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