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

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

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

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

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

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

דוחות שימוש

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

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

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

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

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

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

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

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

  • התרשים תנועה מציג את השימוש במספר השאילתות לשנייה (QPS) לכל API.

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

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

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

ממשקי API למעקב

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

  1. פותחים את דף בחירת הפרויקטים ב-Cloud Console:

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

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

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

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

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

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

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

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

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

    כניסה לדף Google Maps Platform

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

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

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

ממשקי API

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

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

    כניסה לדף Google Maps Platform

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

הדף 'מדדים' במפות 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 Console:

    כניסה לדף Google Maps Platform

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

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

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

הפורמט של פרטי הכניסה משמעות
שם מפתח
לדוגמה, "מפתח אפליקציה לנייד"
נעשה שימוש במפתח API כדי לטעון את ה-API באמצעות ?key=...: אפשר למצוא את שמות המפתחות במסוף הפלטפורמה של מפות Google בקטע Keys & Credentials.
Project Number
לדוגמה, "project_number:123456", כאשר 123456 הוא מספר הפרויקט.
אם פרטי הכניסה האלה מופיעים, יש שתי אפשרויות:
  1. לממשקי API שמקבלים מזהי לקוח בפלטפורמה של מפות Google: כדי לטעון את ה-API, נעשה שימוש במזהה לקוח בפלטפורמה של מפות Google. לדוגמה, באמצעות &client=gme-_mycompany_.

    ממשקי ה-API האלה מקבלים מזהי לקוח: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API, Through Matrix API, Geocoding API, Time Zone API. אפשר לקרוא מידע נוסף במאמר בנושא ניהול מזהי לקוח בתוכנית פרימיום.

  2. בממשקי API שתומכים ב-OAuth: ה-API נטען באמצעות OAuth ללא מפתח API.

תרשימים של קודי תגובה

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

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

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

זוהי בקשה לחיוב והיא תנצל את כל המכסה.

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

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

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

ב-Places API, ההודעה הזו מציינת שהמיקום שיש אליו הפניה (place_id) לא נמצא במסד הנתונים של מקומות.

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

זוהי בקשה לחיוב והיא תנצל את כל המכסה.
REQUEST_DENIED 4xx שגיאת לקוח שנגרמה עקב שגיאת אימות, שגיאת גישה ושגיאות אחרות. פרטים נוספים זמינים בתגובה ל-API.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
resource_EXHAUSTED,
rateLimitExceeded,
DailyLimitExceeded,
userRateLimitExceeded
4xx שגיאת לקוח נגרמה עקב בקשות רבות מדי לתקופת זמן מותרת. אפשר לנסות לשלוח שוב את הבקשה במועד מאוחר יותר. פרטים נוספים זמינים בתגובה ל-API.
INVALID_REQUEST (פרמטר לא חוקי או חסר, ניתוח בקשה או שגיאת אימות) 4xx שגיאת לקוח שנגרמה עקב בקשה לא חוקית. לפרטים נוספים, יש לעיין בתגובת ה-API.
‎NOT_FOUND (404) 4xx ל-Geolocation API, ההודעה הזו מציינת שהקלט לא היה מספיק כדי להעריך את המיקום.

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

זוהי בקשה לחיוב והיא תנצל את מכסת המכסה.
UNKNOWN_ERROR 5xx שגיאת שרת שמציינת שלא ניתן להמשיך בבקשה: שגיאה פנימית, עומס יתר בשירות, לא זמין, תם הזמן הקצוב לתפוגה ועוד.
1 כדי לשפר את העקביות של דיווח על קודי שגיאות, ממשקי ה-API של מפות Google מעבירים את: 1) מסיווג קוד תגובת HTTP 2xx אל 4xx עבור סטטוסים של API של מפות Google: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - סטטוס, 2) מסיווג קוד תגובה של HTTP 2xx עד 4xx עבור סטטוסים של API של מפות Google: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, userRateLimitExceeded קוד של מפות Google, rateLimitExceeded עבור HTTP, מחלקה: 2xx/rateLimitExceeded5xxUNKNOWN_ERROR במהלך תקופת המעבר תוכלו לראות את שני קודי התגובה. קודי תגובה שהוחזרו בתשובות של ה-API של מפות Google לא ישתנו. כדי לוודא שעלייה במדד 4xx ו/או 5xx במדדי הפלטפורמה של מפות Google קשורה להעברה הזו, כדאי לבדוק איזה קוד תגובה מדויק גדל ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).

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

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

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

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

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

דוחות מכסות

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

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

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

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

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

בתרשים המכסות של השימוש במסוף Google Cloud מוצגת התעבורה הכוללת של מפתחות ה-API ומזהי הלקוח. התנועה ב-Client-ID זמינה גם בתרשים המדדים ב-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 (API סטטי של מפות, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API ו-Elevation API), אבל יש כמה יוצאים מן הכלל:

  • ב- בצ'אט מטריצת מרחקים, יחידת המכסה היא רכיב שהוא צמד מוצא-יעד.
  • עבור Maps JavaScript API, יחידת המכסה היא טעינת מפה.
  • ל-SDK של מפות Google ל-Android ול-SDK של מפות Google ל-iOS, יחידת המכסה היא בקשה של Street View או טעינה של פנורמה. טעינות של מפות זמינות ללא חיוב ולא תופסות מכסה.

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

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

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

    כניסה לדף Google Maps Platform

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

יחידות מכסה

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

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

דוחות חיוב

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

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

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

  1. פותחים את דף בחירת הפרויקטים ב-Cloud Console:

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

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

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

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

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

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

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

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

יש מסננים נוספים לדוחות החיוב הבאים: 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>

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

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

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

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

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

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

BigQuery Export מאפשר לייצא באופן אוטומטי ל מערך נתונים נבחר ב-BigQuery, נתונים מפורטים של חיוב ב-Cloud (כמו נתונים לגבי שימוש ואומדן עלות) במהלך היום. לאחר מכן תוכלו לגשת לנתוני החיוב מ-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:

סטטוס התגובה ודוחות

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

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

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

דוחות מעורבות

מדדים עסקיים

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

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

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

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

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

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

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

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

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

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

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

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

Locator Plus

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

  • נכנסים ל-Locator Plus במסוף Google Cloud.
  • עוברים לקטע Engagement Reports (דוחות מעורבות) במסוף Google Cloud כדי להציג את מרכז הבקרה של ניתוח הנתונים.

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

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