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

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

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

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

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

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

דוחות שימוש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הערה: אם בוחרים את השם של ממשק API כלשהו שמופעל, מועברים לדף Metrics של ממשק ה-API הזה במפות Google.

כדי לגשת לדף הסקירה הכללית של Google Maps Platform:

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

   מעבר לדף של Google Maps Platform

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

דף השירותים וממשקי ה-API של Google Maps Platform

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

כדי להיכנס לדף APIs & Services בפלטפורמה של מפות Google:

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

   מעבר לדף של Google Maps Platform

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

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

בדף Metrics של מפות Google מוצגים שלושה תרשימים: Traffic,‏ Errors ו-Median Latency. אפשר לקבץ את נתוני השימוש בתרשימים לפי מחלקה של קוד תגובה, API, שיטת API, פרטי כניסה, פלטפורמה ודומיין.

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

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

הערה: האפשרויות Platform (פלטפורמה) ו-Domain (דומיין) בתפריט הנפתח Grouped by (קיבוץ לפי) והמסננים Platform (פלטפורמה) ו-Domain (דומיין) לא זמינים כשבוחרים באפשרות All Google Maps Platform APIs (כל ממשקי ה-API של הפלטפורמה של מפות Google) בתפריט הנפתח API selection (בחירת API). כדי לבצע ניתוח ברמה גבוהה, השתמשו באפשרות All Google Maps Platform APIs: חפשו ממשקי API ושיטות שיש להם שימוש, בדקו את שיעורי השגיאות ואת השימוש לפי פרטי כניסה. כדי לבצע ניתוח מעמיק של API ספציפי, בוחרים API ספציפי מהרשימה הנפתחת API selection. כשבוחרים ממשק API ספציפי מהרשימה הנפתחת API selection, אפשר לבצע ניתוח מפורט יותר של השימוש ב-API, כמו קיבוץ וסינון לפי Platform ו-Domain.

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

כדי לגשת לדף Google Maps Platform API Metrics:

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

   מעבר לדף של Google Maps Platform

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

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

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

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

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

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

בתרשימים Traffic by response code ו-Error by response code השימוש מחולק לפי מחלקת קוד תגובת HTTP. בטבלה הזו מוצג המיפוי בין סטטוס תגובה מה-API של Google Maps Platform לבין קוד תגובת 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 (Legacy), ההודעה הזו מציינת שלא הצלחנו לבצע גיאו-קידוד של לפחות אחד מהמיקומים שצוינו במקור, ביעד או בנקודות הביניים של הבקשה. ב-Places API, ההודעה הזו מציינת שהמיקום שאליו מתייחסת ההודעה (place_id) לא נמצא במסד הנתונים של Places. זו בקשה לחיוב והיא תנכה מהמכסה.
INVALID_REQUEST (ערך פרמטר לא תקין), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED ועוד.	‫4xx	שגיאה שנגרמת בגלל ערך פרמטר לא תקין. פרטים נוספים מופיעים בתגובה של ה-API. זוהי בקשה לחיוב והיא תנכה מהמכסה.
REQUEST_DENIED	‫4xx	שגיאת לקוח שנגרמה בגלל שגיאת אימות, שגיאת גישה וכו'. כדי לקבל פרטים נוספים, צריך לבדוק את התגובה מה-API.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	‫4xx	שגיאת לקוח שנגרמת בגלל יותר מדי בקשות בפרק זמן מותר. נסו לשלוח את הבקשה שוב מאוחר יותר. כדי לקבל פרטים נוספים, צריך לבדוק את התגובה מה-API.
‫INVALID_REQUEST (פרמטר חסר או לא תקין, שגיאה בניתוח או באימות של הבקשה)	‫4xx	שגיאת לקוח שנגרמת מבקשה לא תקינה. אפשר לבדוק את התגובה מה-API כדי לקבל פרטים נוספים.
‎NOT_FOUND (404)	4xx	בשביל ‫Directions API (Legacy), ההודעה הזו מציינת שלא הייתה אפשרות לבצע קידוד גיאוגרפי של מיקום אחד לפחות שצוין במקור, ביעד או בנקודות הביניים של הבקשה. במקרה של Geolocation API, ההודעה הזו מציינת שהנתונים שהוזנו לא הספיקו כדי להפיק הערכה של המיקום. במקרה של Roads API, ההודעה הזו מציינת שלא הייתה אפשרות להתאים את נתוני הקלט לדרכים בצורה סבירה. זו בקשה לחיוב והיא תנכה מהמכסה.
UNKNOWN_ERROR	5xx	שגיאה בחיבור לשרת שמציינת שלא ניתן להמשיך את הבקשה: שגיאה פנימית, השירות עמוס מדי, השירות לא זמין, חלף הזמן הקצוב לתגובה ועוד.

‫¹ כדי לשפר את העקביות של דיווח קודי השגיאה, ממשקי ה-API של Google Maps Platform עוברים מיגרציה: ‫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. במהלך תקופת המעבר, תוכלו לראות את שני קודי התגובה. קודי התגובה שמוחזרים בתגובות של Maps API לא משתנים. כדי לוודא שהעלייה ב-4xx או ב-5xx במדדים של Google Maps Platform קשורה להעברה הזו, בודקים איזה קוד תגובה בדיוק עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring ל-Google Maps Platform).

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

פרמטר שיוך השימוש ב-Google Maps Platform

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

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

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

הערה: הפרמטר solution_channel עדיין תקף ויכול להיות שהוא מופיע בהטמעות קיימות, אבל אנחנו כבר לא ממליצים להשתמש בו. במקום זאת, אתם צריכים להשתמש ב-internal_usage_attribution_ids.

דוחות מכסות

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

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

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

דף המכסות של מפות 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 Platform ‏(Maps Static API,‏ Street View Static API,‏ Geocoding API,‏ Directions API (Legacy),‏ Places API,‏ Time Zone API,‏ Geolocation API ו-Elevation API), אבל יש כמה יוצאים מן הכלל:

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

כדי לגשת לדף Quotas (מכסות) ב-Google Maps Platform:

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

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

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

יחידות מיכסה

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

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

דוחות חיוב

איך פותחים את דוח החיוב

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

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

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

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

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

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

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

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

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

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

איור 2: טבלת החיוב שבה מוצגים פריטי השימוש והעלות לפי מק"ט.

איור 3: המסננים בדוח החיוב.

כדי לשנות את תצוגת הדוח כך שיוצגו פריטים לפי מק"ט:

1. בחלונית שמימין לתרשים, מרחיבים את המסנן קיבוץ לפי.
2. בוחרים SKU.

מסננים אחרים שזמינים בדוח החיוב כוללים טווח תאריכים, ‏ 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 אחד).

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

הערה: נתוני הערוץ לא זמינים ב-SDK של מפות ל-Android, ב-SDK של מפות ל-iOS, ב-Places API (חדש), ב-Places SDK ל-Android, ב-Places SDK ל-iOS, ב-Navigation SDK ל-Android, ב-Navigation SDK ל-iOS, ב-Places Aggregate API, ב-Address Validation API, ב-Aerial View API, ב-Air Quality API, ב-Map Tiles API, ב-Maps Datasets API, ב-Roads API, ב-Routes API, ב-Pollen API, ב-Solar API, ב-Route Optimization API וב-Weather API.

איור 4: סינון לפי מק"ט וערוצים

כדי לסנן את דוח החיוב לפי מק"ט וערוץ

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

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

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

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

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

אתם יכולים להשתמש בייצוא ל-BigQuery כדי לייצא באופן אוטומטי במהלך היום את נתוני החיוב המפורטים ב-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.

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

  #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:

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

Google Maps Platform:

• חיוב ב-Google Maps Platform
• מדריך לאופטימיזציה
• שיטות מומלצות לשימוש במפתחות API

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

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

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

דוח השימוש במדדים של 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	‫4xx^1	כן	כן	כן
‫INVALID_REQUEST (ערך פרמטר לא תקין), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, וכו'.	‫200, 400	‫4xx	כן	כן	כן
INVALID_REQUEST (פרמטר לא תקין או חסר, שגיאת ניתוח בקשה)	‫200, 400	‫4xx	כן	לא	לא
REQUEST_DENIED	‫200, ‫400, ‫403	‫4xx^1	כן	לא	לא
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	‫200, 403, 429	‫4xx^1	כן	לא	לא
UNKNOWN_ERROR	‫200, ‫500, ‫503	‫5xx^1	כן	כן	לא
‫^1 כדי לשפר את העקביות של הדיווח על קודי שגיאה, ממשקי ה-API של Google Maps Platform עוברים מיגרציה: ‫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. במהלך תקופת המעבר, תוכלו לראות את שני קודי התגובה. קודי התגובה שמוחזרים בתגובות של Maps API לא משתנים. כדי לוודא שהעלייה בערכים 4xx ו/או 5xx במדדים של Google Maps Platform קשורה להעברה הזו, בודקים אילו קודי תגובה בדיוק עלו בMetrics Explorer (מידע נוסף על שימוש ב-Google Cloud Monitoring ל-Google Maps Platform).