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

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

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

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

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

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

דוחות שימוש

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

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

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

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

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

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

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

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

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

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

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

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

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

כדי לגשת לדף APIs & Services Dashboard:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

דף המדדים של מפות Google

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

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

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

הערה: האפשרויות Platform ו-Domain ברשימה הנפתחת קיבוץ לפי, והמסננים Platform ו-Domain, לא זמינים כשבוחרים באפשרות All Google Maps Platform APIs ברשימה הנפתחת API selection. כדי לבצע ניתוח ברמה גבוהה, השתמשו באפשרות All Google Maps Platform APIs: חפשו ממשקי 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

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

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

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

פורמט פרטי הכניסה	משמעות
שם המפתח לדוגמה, "מפתח לאפליקציה לנייד"	מפתח 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 לבין סיווג קוד התגובה של 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	במשך ‫Directions API (גרסה קודמת), ההודעה הזו מציינת שלא ניתן היה להמיר לקואורדינטות לפחות אחד מהמיקומים שצוינו בנקודת המוצא, ביעד או בנקודות הדרך של הבקשה. ב-Geolocation API, ההודעה הזו מציינת שהקלט לא הספיק כדי להפיק הערכת מיקום. ב-Roads API, ההודעה הזו מציינת שלא ניתן היה להצמיד את הקלט לכבישים באופן סביר. זו בקשה לחיוב והיא תנצל את המכסה.
UNKNOWN_ERROR	5xx	שגיאה בחיבור לשרת שמציינת שלא ניתן להמשיך בטיפול בבקשה: שגיאה פנימית, עומס בשירות, השירות לא זמין, תם הזמן הקצוב לתפוגה ועוד.

¹ כדי לשפר את העקביות של דיווח על קודי שגיאה, ממשקי ה-API של Google Maps Platform עוברים: 1) ממחלקת קוד תגובת HTTP‏ 2xx ל-4xx עבור סטטוסים של Maps API‏: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS – סטטוס, 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 הרלוונטי (לדוגמה, תגובות להמרת כתובות לקואורדינטות או תגובות לקבלת מסלול).

פרמטר שיוך (Attribution) של שימוש ב-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.

דוחות מכסות

המכסות מגבילות את מספר הבקשות שהפרויקט יכול לשלוח לממשקי ה-API של 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 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 ב-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	טעינת מפה אחת
Street View Static API	בקשה אחת
Maps Embed API	טעינת מפה אחת
מסלולים
‫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 Experiments	בקשה אחת
סביבה
‫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. בתפריט הימני, לוחצים על Reports כדי לפתוח את הדף Reports של החשבון לחיוב שמקושר לפרויקט.

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

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

איור 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>

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

הערה: נתוני הערוצים לא זמינים ב-SDK של מפות ל-Android, ב-SDK של מפות ל-iOS, ב-Places API (New), ב-Places SDK for Android, ב-Places SDK for iOS, ב-Navigation SDK for Android, ב-Navigation SDK for 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. בתפריט הנפתח Value, בוחרים את הערוצים המספריים שרוצים לסנן.

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

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

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

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

אתם יכולים להשתמש ב-BigQuery Export כדי לייצא באופן אוטומטי במהלך היום את נתוני החיוב המפורטים ב-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 שמוחזר בתגובה לבקשות API של Google Maps Platform יכול להיות שונה מקוד תגובת ה-HTTP בדוחות השימוש (מדדי Google Maps Platform). המדדים של דוחות השימוש משתמשים בקבוצה של ערכי קוד תגובה שתואמים לאלה שמשמשים בממשקי API חדשים יותר. כך אפשר לשפר את הניראות (observability) של השימוש בממשקי ה-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 – סטטוס,‏ 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).