דף זה תורגם על ידי Cloud Translation API.

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

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

סוגי הדוחות:

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

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

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

דוחות שימוש

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

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

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

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

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

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

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

ממשקי API למעקב

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

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

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

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

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

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

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

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

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

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

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

API

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

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

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

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

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

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

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

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

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

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

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

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

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

הפורמט של פרטי הכניסה משמעות

שם מפתח
לדוגמה, 'מפתח אפליקציה לנייד' השתמשנו במפתח API כדי לטעון את ה-API באמצעות ?key=...: שמות המפתחות מופיעים במסוף של מפות Google בקטע Keys & Credentials.

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

מספר הפרויקט
לדוגמה, '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.

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

בתרשימים Traffic לפי קוד תגובה ושגיאה לפי קוד תגובה מפצלים את השימוש לפי מחלקה של קוד תגובת HTTP. בטבלה הזו מוצג המיפוי בין סטטוס התגובה של Google Maps Platform API לבין מחלקה של קוד תגובת HTTP:

סטטוס ה-API של מפות Google	סיווג של קוד תגובת HTTP – דוח שימוש (2xx, 3xx, 4xx, 5xx)	הערות
אישור	2xx	התשובה הצליחה. זוהי בקשה לחיוב והיא תנצל מכסה.
אישור	3xx	התשובה הצליחה. זוהי בקשה לחיוב והיא תנצל מכסה. לדוגמה, בקשות שבוצעו בהצלחה של תמונה של מקום מחזירות הפניה אוטומטית מסוג 302 לתמונה שאליה מתבצעת ההפניה.
DATA_NOT_AVAILABLE	4xx⁽¹⁾	תגובה מוצלחת שמציינת שאין נתונים זמינים לגבי מיקומי הקלט. זוהי בקשה לחיוב והיא תנצל מכסה.
ZERO_RESULTS	4xx⁽¹⁾	תשובה מוצלחת לא החזירה תוצאה. זוהי בקשה לחיוב והיא תנצל מכסה.
NOT_FOUND	4xx⁽¹⁾	לגבי 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, userRateLimit exceededed	4xx	שגיאת לקוח שנגרמה עקב בקשות רבות מדי לכל פרק זמן מותר. אפשר לנסות שוב את הבקשה במועד מאוחר יותר. לפרטים נוספים, אפשר לעיין בתשובה שהתקבלה מה-API.
INVALID_REQUEST (פרמטר לא חוקי או חסר, שגיאת ניתוח או אימות בקשה)	4xx	שגיאת לקוח שנגרמה עקב בקשה לא חוקית. לקבלת פרטים נוספים אפשר לעיין בתשובה מה-API.
‎NOT_FOUND (404)	4xx	ב-Geolocation API, ההודעה הזו מציינת שערכי הקלט לא מספיקים כדי ליצור הערכת מיקום. ב-Roads API, ההודעה הזו מציינת שלא ניתן היה להצמיד את הקלט לכבישים בצורה סבירה. זוהי בקשה לחיוב והיא תנצל מכסה.
UNKNOWN_ERROR	5xx	שגיאה בחיבור לשרת שמציינת שלא ניתן להמשיך בבקשה: שגיאה פנימית, שירות עומס יתר, לא זמין, תם הזמן הקצוב לתפוגה ועוד.
¹ כדי לשפר את העקביות בדיווח על קודי שגיאות, ממשקי ה-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`, סטטוס של HTTP}, `dailyLimitExceeded`, `rateLimitExceeded`, `2xx`/`userRateLimitExceeded5xxUNKNOWN_ERROR` תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי תגובה שמוחזרים בתשובות מה-API של מפות Google לא משתנים. מוודאים שהעלייה ב-`4xx` או ב-`5xx` במדדי הפלטפורמה של מפות Google קשורה להעברה הזו באמצעות בדיקה איזה קוד תגובה מדויק עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).

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

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

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

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

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

דוחות מכסות

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

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

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

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

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

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

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

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

יחידת המכסה היא בקשה לרוב ממשקי ה-API של הפלטפורמה של מפות Google (API של מפות Google, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API ו-Elevation API), אבל יש כמה יוצאים מן הכלל:

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

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

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

פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
לדף הפלטפורמה של מפות Google
בתפריט הימני, בוחרים באפשרות Quotas.
בוחרים API מהרשימה הנפתחת של ה-API.

יחידות מכסה

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

API של הפלטפורמה של מפות Google	יחידת מכסה
מפות
SDK של מפות ל-Android	פנורמה אחת
SDK של מפות ל-iOS	פנורמה אחת
Map Tiles API	בקשה אחת
API של תצוגה אווירית של מפות Google	בקשה אחת
Maps Static API	בקשה אחת
Maps JavaScript API	טעינת מפה אחת
Street View Static API	בקשה אחת
Maps Embed API	טעינת מפה אחת
מסלולים
Routes API (Compute Routes)	בקשה אחת
Routes API (מטריצת נתיב של Compute)	רכיב 1 (צמד מקור-יעד)
Directions API	בקשה אחת
Distance Matrix API	רכיב 1 (צמד מקור-יעד)
Roads API	בקשה אחת
API לאופטימיזציה של מסלולים	בקשה אחת
מקומות
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. מידע נוסף זמין במאמר חיוב.

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

פותחים את הדף 'בורר פרויקטים' במסוף Cloud:
הדף 'בורר פרויקטים'
בוחרים פרויקט.
לוחצים על לחצן התפריט ואז בוחרים באפשרות חיוב.
אם יש לכם כמה חשבונות לחיוב, לוחצים על Go to linked billing account כדי לפתוח את הדף Overview של החשבון המקושר לחיוב.
בתפריט הימני בוחרים באפשרות Reports כדי לפתוח את דף Reports של החיוב של החשבון לחיוב שקישרתם.

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

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

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

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

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

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

צילום מסך של המסננים של דוח החיוב — **איור 3:** סינון דוח החיוב.

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

בחלונית שמשמאל לתרשים, מרחיבים את המסנן Group by.
בוחרים באפשרות מק"ט.

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

הערה: ייתכן שההטמעה תתבצע באמצעות כמה ממשקי API שניתנים לחיוב, לכן צריך לשנות את המשוואה לפי הצורך. חשוב לזכור: בכל חודש מקבלים זיכוי בסך 200 דולר ארה"ב (USD) לפלטפורמה של מפות Google, אז הקפידו להביא זאת בחשבון בחישוב שלכם.

מעקב אחר שימוש בכל ערוץ

כדי לעקוב אחרי השימוש בערוצים מספריים, צריך להוסיף את הפרמטר '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

JavaScript API של מפות Google

<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
async defer></script>

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

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

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

משתמשים במסנן Group by כדי להגדיר מק"ט.
בוחרים את סמן הטקסט Labels.
לוחצים על התפריט הנפתח Key ובוחרים באפשרות goog-maps-channel.
לוחצים על התפריט הנפתח ערך ובוחרים את הערוצים המספריים שרוצים לסנן.

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

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

ייצוא נתוני החיוב ל-BigQuery

אתם יכולים גם לייצא את נתוני החיוב ל-BigQuery.

BigQuery Export מאפשר לייצא באופן אוטומטי נתונים מפורטים של חיוב ב-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 בדוח השימוש, ומציין אם הבקשה תואמת מופיעה בדוחות Usage, Quota ו-Billing.

דוח השימוש במדדי הפלטפורמה של מפות 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	4xx¹	כן	כן	כן
INVALID_REQUEST (ערך פרמטר לא חוקי), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, וכו'	200, 400	4xx	כן	כן	כן
INVALID_REQUEST (פרמטר לא חוקי/חסר, שגיאה בניתוח בקשה)	200, 400	4xx	כן	לא	לא
REQUEST_DENIED	200, 400, 403	4xx¹	כן	לא	לא
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, Resource_EXHAUSTED, DailyLimitExceeded, rateLimitExceeded, userRateLimitExceed	200, 403, 429	4xx¹	כן	לא	לא
UNKNOWN_ERROR	200, 500, 503	5xx¹	כן	כן	לא
¹ כדי לשפר את העקביות בדיווח על קודי שגיאות, ממשקי ה-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`, סטטוס של HTTP}, `dailyLimitExceeded`, `rateLimitExceeded`, `2xx`/`userRateLimitExceeded5xxUNKNOWN_ERROR` תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי תגובה שמוחזרים בתשובות מה-API של מפות Google לא משתנים. מוודאים שהעלייה ב-`4xx` או ב-`5xx` במדדי הפלטפורמה של מפות Google קשורה להעברה הזו באמצעות בדיקה איזה קוד תגובה מדויק עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).

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

מדדים עסקיים

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

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

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

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

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

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

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

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

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

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

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

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

Locator Plus

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

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

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

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