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

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

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

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

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

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

דוחות שימוש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

2. בוחרים את הפרויקט הרצוי. יופיע מרכז הבקרה של השירותים וממשקי ה-API.
   
   אם הדף לא מופיע, לוחצים על לחצן התפריט ואז על APIs & Services (ממשקי API ושירותים).

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

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

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

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

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

   כניסה לדף של Google Maps Platform

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

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

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

כדי לגשת לדף 'ממשקי API ושירותים' של Google Maps Platform:

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

   כניסה לדף של Google Maps Platform

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

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

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

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

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

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

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

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

   כניסה לדף של Google Maps Platform

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

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

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

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

בתרשימים Traffic by response code ו-Error by response code השימוש מחולק לפי מחלקת קוד תגובת HTTP. בטבלה הזו מוצג המיפוי בין סטטוס התגובה של API בפלטפורמה של Google Maps לבין מחלקת קוד התגובה של HTTP:

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

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

פרמטר שיוך השימוש ב-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.

דוחות מכסות

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

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

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

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

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

בתרשים של ניצול המכסה במסוף Google Cloud מוצגת התנועה הכוללת של מפתחות ה-API ומזהי הלקוח. נתוני התנועה של מזהה הלקוח זמינים גם בתרשים Metrics (מדדים) ב-מסוף 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 Maps Platform

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

יחידות מיכסה

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

דוחות חיוב

צפייה בדוח החיוב

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

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

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

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

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

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

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

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

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

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

1. בחלונית שמימין לתרשים, מרחיבים את המסנן קיבוץ לפי.
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

  usage, כדי לנהל את עלות השימוש בממשקי 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.

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

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

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

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

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

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

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

כדי להתחיל לייצא נתונים ל-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:

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

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

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

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

דוח השימוש במדדים של Google Maps Platform

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

זמין במעקב אחר השימוש ב-Google Maps Platform.