การรายงาน 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 ดูข้อมูลเพิ่มเติมได้ที่ การจัดการรหัสไคลเอ็นต์ของแพ็กเกจ 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 สําหรับ 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 ที่คุณสนใจ (เช่น การตอบกลับการแปลงพิกัดภูมิศาสตร์หรือการตอบกลับเส้นทาง)

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

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

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 ใน Cloud Console โดยทำดังนี้

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

  2. เลือกโควต้าในเมนูด้านซ้าย
  3. เลือก API จากรายการแบบเลื่อนลงของ API

หน่วยโควต้า

ตารางนี้แสดงหน่วยโควต้าสำหรับ API ของ Google Maps Platform

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 รายการ
สภาพแวดล้อม
Air Quality 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 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 จะช่วยให้คุณส่งออกข้อมูลการเรียกเก็บเงินในระบบคลาวด์โดยละเอียด (เช่น ข้อมูลการใช้งานและค่าใช้จ่ายโดยประมาณ) ไปยัง ชุดข้อมูล 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
  

การเรียกเก็บเงินในระบบคลาวด์

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 จะดูข้อมูลเชิงลึกทางธุรกิจได้ในหน้าเมตริกใน Cloud Console โปรเจ็กต์ต้องเปิดใช้ Maps JavaScript API

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

ผู้ใช้สามารถส่งออกชุดข้อมูลทั้งหมดหรือมุมมองที่กรองแล้วเป็น CSV เพื่อวิเคราะห์เพิ่มเติมในเครื่องมือวิเคราะห์ธุรกิจที่คุณชื่นชอบ คุณสามารถดาวน์โหลดข้อมูลย้อนหลังได้สูงสุด 90 วันพร้อมกัน และการดาวน์โหลดที่มีเซลล์มากกว่า 60,000 รายการจะถูกตัดให้สั้นลง การส่งออกข้อมูลมุมมองแผนที่ไปยัง CSV อาจใช้เวลา 2-3 นาที ทั้งนี้ขึ้นอยู่กับช่วงวันที่ที่เลือก

การส่งออกข้อมูลเชิงลึกทางธุรกิจ

เมตริกข้อมูลเชิงลึกทางธุรกิจจะลบข้อมูลระบุตัวบุคคลออก ดังนั้นจึงแสดงเฉพาะแนวโน้มโดยรวมของการมีส่วนร่วมกับแผนที่ของคุณ ระบบอาจปัดเศษจํานวนต่ำเป็น 0 และลดการมีส่วนร่วมจากค่าเบี่ยงเบน

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

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