דיווח בפלטפורמה של מפות Google

דיווח בפלטפורמת מפות Google מספק קבוצה של דוחות חזותיים מוגדרים מראש של נתוני שימוש בסיסיים ב-API, מכסות ופרטי חיוב במסוף Google Cloud. אתם יכולים להשתמש בדוחות האלה כדי לקבוע את מספר הקריאות ל-API שביצעתם, את מידת הקרבה שלכם למכסות השימוש ב-API ולעקוב אחרי השימוש לחיוב לאורך זמן.

סוגי הדוחות כוללים:

  • דוחות שימוש: דוחות על מספר הבקשות שהפרויקט שלכם שולח לממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה שמשויכים לפרויקט.
  • דוחות מכסות: דוחות על השימוש במכסות בתרשים שאפשר לקבץ לפי בקשות לדקה. המכסות הקיימות לממשקי API נבחרים מוצגות בטבלאות מתחת לתרשים השימוש במכסות.
  • דוחות חיוב: הדוח מציג את העלויות לאורך זמן כתרשים קו מוערם. הצגת השימוש במכסה בחודש הנוכחי, כולל זיכויים שהוחלו לפי שימוש ספציפי, וגם את העלות הצפויה הכוללת לכל החודש הנוכחי.
  • דוחות התעניינות: מספקים תובנות עסקיות לגבי האופן שבו משתמשים מקיימים אינטראקציה עם אפליקציות המפות שלכם.

בדוחות סטטוס התשובות והדוחות תוכלו למצוא רשימה מלאה של סטטוסי התשובות וקודי התשובות שמגדירים אם בקשה מופיעה בדוחות Usage, Quota ו-Billing.

אפשר להציג את הדוחות של השימוש, המכסות והחיוב בפלטפורמה של מפות Google באמצעות מסוף Cloud.

דוחות שימוש

השימוש מבוסס על מספר הבקשות שהפרויקט שולח לממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה שמשויכים לפרויקט. הבקשות כוללות בקשות שהצליחו, בקשות שהובילו לשגיאות בשרת ובקשות שהובילו לשגיאות בלקוח. פרטי הכניסה כוללים מפתחות API ומזהי לקוח (לפרויקטים בתוכנית Premium ולפרויקטים שהועברו מתוכנית Premium). פרטים נוספים זמינים בסקירה הכללית על תוכנית Premium ובמידע על השימוש במזהה לקוח.

מדדי השימוש מוצגים בטבלאות (בקשות, שגיאות וזמן אחזור) ובתרשימים (תנועה, שגיאות וזמן אחזור). למטרות מעקב:

  • כל ממשקי ה-API: אפשר לסנן ולקבץ מדדי שימוש של כל ממשקי ה-API בדרכים הבאות:

    • סינון לפי תקופה ו-API.
    • הצגת נתוני תנועה, שגיאות וזמן אחזור שמקובצים לפי קוד תגובה, API ופרטי כניסה.
  • API ספציפי: אפשר לסנן ולאגד מדדי שימוש של API ספציפי בדרכים הבאות:

    • סינון לפי תקופת זמן, גרסאות API, פרטי כניסה ושיטות.
    • הצגת נתוני התנועה, השגיאות והזמן האחזור שמקובצים לפי קוד התגובה, שיטת ה-API והגרסה, והפרטים האישיים המזהים.

הדף של מרכז הבקרה של השירותים וממשקי ה-API

בלוח הבקרה של ממשקי ה-API והשירותים מוצגת סקירה כללית של מדדי השימוש בכל ממשקי ה-API שהופעלו בפרויקט: ממשקי ה-API של הפלטפורמה של מפות Google וכן ממשקי API ושירותים אחרים.

  • בדף Dashboard מוצגים שלושה גרפים וטבלה. אפשר לסנן את נתוני השימוש שמוצגים בתרשים ובטבלה על ידי בחירה של תקופת זמן, החל משעה אחת ועד 30 הימים האחרונים.

  • בתרשים תנועה מוצג השימוש בשאילתות לדקה (QPM) לכל ממשק API.

  • בתרשים שגיאות מוצג אחוז הבקשות שהובילו לשגיאות לכל ממשק API.

  • בתרשים Latency מוצג זמן האחזור החציוני של הבקשות לכל API.

מתחת לתרשים מופיעה טבלה עם רשימת ה-API והשירותים המופעלים. 'בקשות' הוא מספר הבקשות (בתקופת הזמן שנבחרה). השגיאות הן מספר הבקשות האלה שהובילו לשגיאות. זמן האחזור (זמן אחזור בינוני ופריסנטיל) הוא זמן האחזור של הבקשות האלה.

ממשקי API למעקב

כדי לגשת לדף של מרכז הבקרה של השירותים וממשקי ה-API:

  1. פותחים את הדף Project selector במסוף Cloud:

    הדף לבחירת פרויקט

  2. בוחרים את הפרויקט הרצוי. מופיע הדף של מרכז הבקרה של השירותים וממשקי ה-API.

    אם הדף לא מופיע, לוחצים על לחצן התפריט תפריט ואז על APIs & Services.

מידע נוסף זמין במאמר מעקב אחר השימוש ב-API.

דף הסקירה הכללית של מפות Google

בדף סקירה כללית של מפות Google מופיעה טבלה עם רשימת ממשקי ה-API שהופעלו ובקשות השימוש מ-30 הימים האחרונים. הבקשות לפי API מוצגות גם בתרשים. בתרשים החיוב מוצגים החשבונית הנוכחית והשימוש הכולל ב-3 החודשים האחרונים.

צילום מסך של תרשים סקירה כללית שבו מוצגת טבלה עם רשימת ממשקי ה-API המופעלים ובקשות ה-API מ-30 הימים האחרונים.

כדי לגשת לדף הסקירה הכללית של הפלטפורמה של מפות Google:

  1. פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:

    לדף של הפלטפורמה של מפות Google

  2. בתפריט הימני, לוחצים על סקירה כללית.

הדף 'שירותים וממשקי API של הפלטפורמה של מפות Google'

הדף APIs & Services של מפות Google מכיל רשת של משבצות שמייצגות את ממשקי ה-API, ערכות ה-SDK והשירותים האחרים שזמינים לפרויקט. בכל משבצת אפשר להפעיל או להשבית את השירות על ידי בחירה באפשרות Enable (הפעלה) או Disable (השבתה). בנוסף, אפשר לגשת למידע על פרטי הכניסה, למדדים ולמדריכים למשתמש של ממשקי ה-API המופעלים. אפשר גם להשתמש במסנני הדף כדי להציג שירותים מופעלים או מושבתים וקטגוריות שירות אחרות.

apis

כדי לגשת לדף 'שירותים וממשקי API של הפלטפורמה של מפות Google':

  1. פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:

    לדף של הפלטפורמה של מפות Google

  2. בתפריט הימני, לוחצים על APIs & Services.

הדף 'מדדים' במפות Google

בדף מדדים של מפות Google מוצגים שלושה תרשימים: תנועה, שגיאות וזמן אחזור חציוני. אפשר לקבץ את נתוני השימוש בתרשים לפי סיווג של קוד תגובה, API, שיטת API, פרטי כניסה, פלטפורמה ודומיין.

מתחת לתרשים, בדף Metrics יש טבלה של ממשקי API שמציגה בקשות, שגיאות וזמן אחזור של ממשקי ה-API שבחרתם.

באמצעות התפריט הנפתח של ממשקי ה-API בחלק העליון, ואפשרויות הקיבוץ והסינון שבחלונית השמאלית, תוכלו לקבץ ולסנן את מדדי השימוש המוצגים על ידי בחירת ממשקי API ספציפיים או מרובים, פרטי כניסה, סיווגים של קודי תגובה, סוג פלטפורמה ו/או דומיין. אפשר גם לבחור פרק זמן (משעה אחת ועד 30 הימים האחרונים) ורמת פירוט (לשנייה או ליום) של מדדי השימוש שמוצגים.

דף המדדים שבו מוצגים שלושה תרשימים: תנועה, שגיאות וזמן אחזור חציוני.

בתמונות הבאות מוצגים המסננים Platform ו-Domain ל-API יחיד, כשהאפשרויות Platform ו-Domain מסומנות ברשימה הנפתחת Grouped by:

המסנן 'פלטפורמה' מופיע רק כשבוחרים ממשק API יחיד. המסנן 'פלטפורמה' מופיע רק כשבוחרים ממשק API יחיד.

כדי לגשת לדף המדדים של Google Maps Platform API:

  1. פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:

    לדף של הפלטפורמה של מפות Google

  2. בתפריט הימני, לוחצים על מדדים.

דיווח על פרטי כניסה

אפשר לסנן ולקבץ מדדים לפי פרטי הכניסה ששימשו לטעינת ה-API.

פורמט פרטי הכניסה משמעות
שם המפתח
לדוגמה, 'מפתח לאפליקציה לנייד'
נעשה שימוש במפתח API כדי לטעון את ה-API באמצעות ?key=...: שמות המפתחות מופיעים במסוף של פלטפורמת מפות Google בקטע Keys & Credentials.
מספר הפרויקט
לדוגמה, 'project_number:123456', כאשר 123456 הוא מספר הפרויקט.
אם אתם רואים את פרטי הכניסה האלה, יש שתי אפשרויות:
  1. בממשקי API שתומכים במזהי לקוחות של הפלטפורמה של מפות Google: מזהה לקוח של הפלטפורמה של מפות Google שימש לטעינת ה-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. בטבלה הזו מוצג המיפוי בין סטטוס התגובה של ה-API של הפלטפורמה של מפות Google לבין סיווג קוד התגובה של ה-HTTP:

סטטוס של Maps API סיווג של קודי תגובת HTTP – דוח שימוש
(2xx, ‏ 3xx, ‏ 4xx, ‏ 5xx)
הערות
אישור 2xx תגובה מוצלחת.

זוהי בקשה לחיוב שתצרוך מכסה.
אישור 3xx תגובה מוצלחת.

זוהי בקשה לחיוב שתצרוך מכסה.

לדוגמה, בקשות Place Photo שמתקבלות בהצלחה מחזירות הפניה אוטומטית (302) לתמונה שצוינה.
DATA_NOT_AVAILABLE 4xx(1) תגובה מוצלחת שמציינת שאין נתונים זמינים למיקומי הקלט.

זוהי בקשה לחיוב שתצרוך מכסה.
ZERO_RESULTS 4xx(1) התשובה שהתקבלה לא החזירה תוצאה.

זוהי בקשה לחיוב שתצרוך מכסה.
NOT_FOUND 4xx(1) ב-Directions API, ההודעה הזו מציינת שלא ניתן היה לבצע גיאוקוד של לפחות אחד מהמיקומים שצוינו במקור, ביעד או בנקודות העצירה בבקשה.

ב-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 כדי לשפר את העקביות של הדיווח על קודי שגיאה, אנחנו מעבירים את ממשקי ה-API של פלטפורמת מפות Google: 1) ממעמד 2xx של קוד התגובה ל-HTTP למעמד 4xx עבור מצבי ה-API של מפות Google: DATA_NOT_AVAILABLE, ‏ NOT_FOUND,‏ ZERO_RESULTSstatus, 2) ממעמד 2xx של קוד התגובה ל-HTTP למעמד 4xx עבור מצבי ה-API של מפות Google: REQUEST_DENIED, ‏ OVER_DAILY_LIMIT,‏ OVER_QUERY_LIMIT, ‏ dailyLimitExceeded,‏ rateLimitExceeded, ‏ userRateLimitExceeded, 3) ממעמד 2xx של קוד התגובה ל-HTTP למעמד 5xx עבור מצב ה-API של מפות Google: UNKNOWN_ERROR. תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי התגובה שמוחזרים בתגובות של Maps API לא משתנים. כדי לוודא שהעלייה ב-4xx ו/או ב-5xx במדדים של הפלטפורמה של מפות Google קשורה להעברה הזו, בודקים את קוד התגובה המדויק שמספרו עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).

מידע נוסף על קודי סטטוס והודעות שגיאה זמין במסמכי העזרה של התגובות ל-API הרצוי (לדוגמה, תגובות לגיאוקוד או תגובות למסלול).

פרמטר של פתרונות בפלטפורמה של מפות Google

בפלטפורמה של מפות Google יש סוגים רבים של קוד לדוגמה שיעזרו לכם להתחיל להשתמש בה במהירות. לדוגמה, תוכלו להשתמש ב-Quick Builder במסוף Cloud, לפעול לפי מדריכי ההטמעה של הפתרונות בתחום ולקבל מידע מcodelabs.

כדי להבין את השימוש בפתרונות שלנו ולמצוא דרכים לשיפורם, Google כוללת את פרמטר השאילתה solution_channel בקריאות ל-API כדי לאסוף מידע על השימוש בקוד לדוגמה:

  • פרמטר השאילתה solution_channel כלול כברירת מחדל בקוד לדוגמה של הפתרון.
  • פרמטר השאילתה מחזיר ל-Google ניתוח נתונים על אימוץ הפתרון, כדי לשפר את איכות הפתרון בגרסאות עתידיות.
  • כדי לבטל את ההסכמה, מוחקים את הפרמטר של השאילתה solution_channel ואת הערך שלו מהקוד לדוגמה.
  • אין צורך לשמור את הפרמטר. הסרת הפרמטר של השאילתה לא משפיעה על הביצועים.
  • פרמטר השאילתה משמש רק לדיווח על שימוש בקוד לדוגמה.
  • פרמטר השאילתה נפרד מכל ניתוח ודיווח ספציפיים ל-API. כלומר, הסרת הפרמטר מקובץ הקוד לדוגמה של הפתרון לא משביתה את הדיווח הפנימי של Google Maps JavaScript API.

דוחות מכסות

המכסות קובעות מגבלות על מספר הבקשות שהפרויקט יכול לשלוח לממשקי ה-API של הפלטפורמה של מפות Google. אפשר להגביל את הבקשות בשלוש דרכים: ליום, לדקה ולמשתמש לדקה. רק בקשות שהושלמו ובקשות שגרמו לשגיאות בשרת נספרות במכסה. בקשות שלא עוברות אימות לא נספרות במכסה.

השימוש במכסות מוצג בתרשים בדף Quotas במסוף Cloud, וניתן לקבץ אותו לפי בקשות לדקה. מגבלות המכסות העדכניות לממשקי API נבחרים מוצגות בטבלאות מתחת לתרשים השימוש במכסות.

כדי לקבל את ערך המכסה לדקה לכל מוצר API של GMP, תוכלו להשתמש ב מחשבון הזה.

הדף 'מכסות' במפות Google

בדף Quotas של מפות Google מוצגות המכסות והשימוש במכסות של ממשק ה-API הספציפי שבחרתם.

בתרשים השימוש במכסות במסוף Google Cloud מוצגת התנועה הכוללת של מפתחות ה-API ומזהי הלקוח. נתוני התנועה של מזהי הלקוחות זמינים גם בתרשים המדדים במסוף Cloud.

בדף מוצגות רק בקשות שצורכות מכסה: בקשות מוצלחות (OK,‏ ZERO_RESULTS, ‏ DATA_NOT_AVAILABLE) ובקשות שגורמות לשגיאות שרת (NOT_FOUND, ‏ INVALID_REQUEST/INVALID_VALUE (ערך פרמטר לא חוקי), ‏ UNKNOWN_ERROR).

בקשות שגורמות לשגיאות לקוח – שגיאות אימות, הרשאה ושגיאות של ארגומנטים לא חוקיים (REQUEST_DENIED,‏ OVER_QUERY_LIMIT,‏ INVALID_REQUEST (פרמטר לא חוקי, שגיאה בניתוח הבקשה)) – לא נספרות במכסה ולא מוצגות.

יחידת המכסה היא בקשה לרוב ממשקי ה-API של הפלטפורמה של מפות Google (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, יחידת המכסה היא טעינת מפה.
  • ב-SDK של מפות ל-Android וב-SDK של מפות ל-iOS, יחידת המכסה היא בקשה של Street View או טעינת תמונה פנורמית. העלאות מפות זמינות ללא תשלום ולא נספרות במכסה.

צילום מסך של הדף Quotas ב-Maps במסוף Google Cloud. בדוח מוצגות המכסות לפי API באמצעות בורר, ולאחר מכן מוצגות הטעינות של המפה ביחס למכסות שהוגדרו ל-API הרלוונטי.

כדי לגשת לדף המכסות של הפלטפורמה של מפות Google:

  1. פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:

    לדף של הפלטפורמה של מפות Google

  2. בתפריט הימני, בוחרים באפשרות Quotas.
  3. בוחרים ממשק API מהרשימה הנפתחת של ממשקי ה-API.

יחידות מיכסה

בטבלה הזו מוצגת יחידת המכסה של ממשקי ה-API של הפלטפורמה של מפות Google.

Google Maps Platform API יחידת המכסה
מפות
SDK של מפות ל-Android 1 פנורמה
SDK של מפות ל-iOS 1 פנורמה
Map Tiles API בקשה אחת
Maps Aerial View API בקשה אחת
Maps Static API בקשה אחת
Maps JavaScript API טעינה של מפה אחת
Street View Static API בקשה אחת
Maps Embed API טעינה של מפה אחת
Routes
Routes API‏ (Compute Routes) בקשה אחת
Routes API‏ (Compute Route Matrix) רכיב אחד (צמד מקור-יעד)
Directions API בקשה אחת
Distance Matrix API רכיב אחד (צמד מקור-יעד)
Roads API בקשה אחת
Route Optimization API בקשה אחת
‫Navigation SDK ל-Android יעד אחד
‫Navigation SDK ל-iOS יעד אחד
מקומות
Places API בקשה אחת
Address Validation API בקשה אחת
Geocoding API בקשה אחת
Geolocation API בקשה אחת
Time Zone API בקשה אחת
סביבה
Air Quality API‏ (CurrentConditions ו-HeatmapTile) בקשה אחת
Air Quality API (היסטוריה) דף אחד
Pollen API בקשה אחת
Solar API בקשה אחת

דוחות חיוב

הצגת דוח החיוב

דוחות החיוב על השימוש במוצרי פלטפורמת מפות Google זמינים במסוף Google Cloud. מידע נוסף זמין במאמר חיוב.

כדי לגשת לדוחות החיוב:

  1. פותחים את הדף Project selector במסוף Cloud:

    הדף לבחירת פרויקט

  2. בוחרים פרויקט.
  3. לוחצים על לחצן התפריט תפריט ואז על Billing.
  4. אם יש לכם כמה חשבונות לחיוב, בוחרים באפשרות Go to linked billing account כדי לפתוח את הדף Overview של החשבון לחיוב שמקושר.
  5. בתפריט הימני, בוחרים באפשרות Reports כדי לפתוח את הדף Reports של החיוב בחשבון לחיוב המקושר.

הסבר על המבנה של תרשים הדוח בחיוב

בדוחות החיוב מוצגות העלויות לאורך זמן בתרשים קו מוערם. בתצוגת ברירת המחדל מוצגות העלויות היומיות לפי שימוש ספציפי בחודש הנוכחי, כשהן מקובצות לפי פרויקט (לכל המוצרים), כולל זיכויים שהוחלו לפי שימוש ספציפי, וגם העלות הצפויה הכוללת לכל החודש הנוכחי. כל הקווים בתרשים (והשורות בטבלת הסיכום) תואמים לפרויקט, והם מדורגים לפי גובה העלות בסדר יורד. מידע נוסף על פרשנות התרשים של דוח החיוב

צילום מסך של דוח החיוב שבו מוצגים תרשים וטבלה באמצעות תצוגת ברירת המחדל המוגדרת מראש
איור 1: דוח החיוב שבו מוצגים תרשים וטבלה באמצעות תצוגת ברירת המחדל המוגדרת מראש.

טיפ: ניתוח השימוש והעלות לכל מק"ט

כדי להבין בצורה מדויקת יותר את פרטי מודל התמחור בתשלום לפי שימוש ואת ההשפעה שלו על ההטמעה, כדאי לבדוק את השימוש והעלות לפי מק"ט.

דוח חיוב שמקובץ לפי מק"ט
איור 2: טבלת החיוב שבה מוצגים פריטים של שימוש ועלות לפי מק"ט.
צילום מסך של המסננים בדוח החיוב
איור 3: המסננים של דוח החיוב.
כדי לשנות את תצוגת הדוח כך שתציג פריטים לפי מק"ט:
  1. בחלונית שמשמאל לתרשים, מרחיבים את המסנן Group by.
  2. בוחרים באפשרות מק"ט.

מסננים אחרים שזמינים בדוח החיוב כוללים את Time range, ‏ Projects,‏ Products, ‏ SKUs ו-Locations, שמאפשרים לסנן לפי המיקום שממנו נשלחות בקשות ה-API.

כדי לסווג את מקור השימוש בנוסף למוצר, אפשר לקבץ דוחות חיוב לפי אחד מהערכים המפורטים. שלושת המפתחות שקשורים לממשקי ה-API של הפלטפורמה של מפות Google הם goog-maps-api-key-suffix (ארבעת התווים האחרונים של מפתח API), goog-maps-platform-type (הפלטפורמה: Android,‏ iOS,‏ JavaScript או שירות אינטרנט) ו-goog-maps-channel (ערך ערוץ מספרי מוגדר משאילתת API). מידע נוסף על סינון וקיבוץ

כדי לשנות את תצוגת התרשים כך שלא יכללו זיכויים ספציפיים לשימוש, מבטלים את הסימון של התיבה Include credits in cost בחלונית השמאלית.

מעקב אחר הצריכה והגבלתה

כדי לתכנן את התקציב ולשלוט בעלויות, אפשר:

  • להגדיר התראה לגבי התקציב כדי לעקוב אחרי ההתקדמות של ההוצאות לעבר סכום מסוים. הגדרת תקציב לא מגבילה את השימוש ב-API, אלא רק מאפשרת לקבל התראות כשסכום ההוצאה מתקרב לסכום שצוין.
  • הגדרת מכסה על השימוש היומי ב-API כדי לנהל את עלות השימוש בממשקי API לחיוב. הגדרת מכסות לבקשות ליום מאפשרת לכם להגביל את ההוצאות. אפשר להשתמש במשוואה פשוטה כדי לקבוע את המכסה היומית בהתאם לסכום שאתם רוצים להוציא. לדוגמה: (הוצאה חודשית /מחיר לכל מק"ט)/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>

אתם יכולים לעקוב אחרי השימוש בערוץ ישירות בדוח החיוב. הערוצים יופיעו בקטע Labels (תוויות) כמפתח goog-maps-channel.

סינון לפי תוויות
איור 4: סינון לפי מק"ט וערוצים
כדי לסנן את דוח החיוב לפי מק"ט וערוץ
  1. משתמשים במסנן Group by (קיבוץ לפי) של המק"ט.
  2. בוחרים את החץ Labels.
  3. בתפריט הנפתח Key, בוחרים באפשרות goog-maps-channel.
  4. בוחרים בתפריט הנפתח Value ובוחרים את הערוצים המספריים שרוצים לסנן.

מקבצים לפי המפתח של תווית העלות goog-maps-channel כדי לראות את העלות שנוצרה מכל ערוץ.

אחרי שתטמיעו את נתוני השימוש בערוץ בבקשות שלכם, יכול להיות שיחלוף עיכוב קצר (עד 24 שעות) עד שהנתונים יופיעו בדוח החיוב.

ייצוא נתוני החיוב באמצעות BigQuery

אפשר גם לייצא את נתוני החיוב ל-BigQuery.

הייצוא ל-BigQuery מאפשר לייצא באופן אוטומטי במהלך היום נתוני חיוב מפורטים ב-Cloud (כמו נתוני שימוש ונתוני אומדן עלות) ל מערך נתונים נבחר ב-BigQuery. לאחר מכן תוכלו לגשת לנתוני החיוב מ-BigQuery לצורכי ניתוח מפורט. כך תוכלו להבין טוב יותר את מקור השימוש בפלטפורמה של מפות Google.

כדי להתחיל לייצא נתונים ל-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 API, קוד התגובה של HTTP שמוחזר בתשובות של Maps API וסיווג קוד התגובה של HTTP בדוח השימוש. בנוסף, בטבלה מצוין אם הבקשה המתאימה מופיעה בדוחות 'שימוש', 'מכסות' ו'חיוב'.

דוח השימוש במדדים של פלטפורמת מפות Google מספק רמת פירוט של HTTP response code class. אם אתם צריכים רמת פירוט גבוהה יותר, תוכלו לעיין בקודי סטטוס התשובה שזמינים במעקב אחר השימוש בפלטפורמה של מפות Google.

קודי התגובה שזמינים בתשובות של 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 כדי לשפר את העקביות של הדיווח על קודי שגיאה, אנחנו מעבירים את ממשקי ה-API של פלטפורמת מפות Google: 1) ממעמד קוד התגובה HTTP 2xx למעמד 4xx עבור מצבי Maps API: DATA_NOT_AVAILABLE, ‏ NOT_FOUND,‏ ZERO_RESULTSstatus, 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. תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי התגובה שמוחזרים בתגובות של Maps API לא משתנים. כדי לוודא שהעלייה במדדים 4xx ו/או 5xx במדדי הפלטפורמה של מפות Google קשורה להעברה הזו, בודקים את קוד התגובה המדויק שמספרו עולה בMetrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).

דוחות על היקף המעורבות של הצופים

מדדים עסקיים

פלטפורמת מפות Google מספקת תובנות לגבי האופן שבו המשתמשים מקיימים אינטראקציה עם המפות שלכם. התובנות האלה כוללות מדדי מעורבות מרכזיים כמו צפיות במפה או אינטראקציות עם נקודת עניין. אתם יכולים לנתח את התובנות האלה כדי לזהות מיקומים פופולריים לפרסום ולשיווק, או כדי לבצע אופטימיזציה של חוויית המשתמש.

יכולות הדיווח של תובנות עסקיות כוללות:

  • הצגת תמונת מצב ברמה גבוהה של תובנות עסקיות כדי לראות מגמות עיקריות בתובנות העסקיות במבט מהיר
  • ניתוח מעמיק של מדד ספציפי במסוף כדי להבין את המדדים לעומק
  • ייצוא מדדים לקובץ CSV כדי שתוכלו לנתח את נתוני התובנות העסקיות בכלי הניתוח העסקי המועדף עליכם

מדדי המעורבות הזמינים כוללים:

  • תצוגות מפה: מעקב אחרי תצוגות במפה שנובעות מתנועות פנורמיות, שינוי מרחק התצוגה או הטיה. התצוגות במפה מחושבות לפי מיקוד על בסיס שבועי (מיום ראשון עד יום שבת לפי שעון החוף המערבי). נתונים חדשים מתפרסמים מדי שבוע ביום רביעי הראשון לאחר תקופת המעקב.

בעלי פרויקטים ומשתמשים עם התפקיד צפייה בניתוח נתונים של מפות Google יכולים לראות תובנות עסקיות בדף המדדים במסוף Cloud. צריך להפעיל את Maps JavaScript API בפרויקט.

אתם יכולים לנתח מדדי התעניינות ישירות במסוף באמצעות התכונות 'סינון' ו'קיבוץ לפי', כדי להתעמק במדדים בפירוט רב יותר. לדוגמה, אפשר לסנן לפי אזור ספציפי כדי לבדוק את המגמות של צפיות במפה רק במספרי מיקוד באזור הזה. מצד שני, יכול להיות שתרצו לקבץ לפי אזור ספציפי כדי לצבור אינטראקציות בתוך האזור הזה.

המשתמשים יכולים לייצא את כל קבוצת הנתונים או תצוגה מסוננת לקובץ CSV כדי לנתח אותם לעומק בכלי הניתוח העסקי המועדף עליהם. אפשר להוריד עד 90 ימים בכל פעם, והורדות של יותר מ-60,000 תאים יקוצצו. ייצוא נתוני צפיות במפה לקובץ CSV עשוי להימשך כמה דקות, בהתאם לטווח הזמן שנבחר.

ייצוא תובנות עסקיות

המדדים של תובנות העסק אנונימיים, ולכן הם משקפים רק מגמות כלליות במעורבות עם המפות שלכם. ייתכן שמספרים נמוכים יעוגלו לאפס, וייתכן שתרומות של ערכים חריגים יצומצמו.

אתם יכולים לשלוט בגישה לתובנות העסקיות של הפרויקט ב-Cloud במסוף Google Cloud באמצעות ההרשאה Maps Analytics. הבעלים של הפרויקט מקבלים את ההרשאה הזו כברירת מחדל, והם יכולים להקצות גישה למשתמשים אחרים לפי הצורך.

אין להשתמש בתובנות עסקיות כדי להעריך את עלויות השימוש. מידע נוסף על השימוש זמין בדוחות השימוש.