דיווח בפלטפורמת מפות Google מספק קבוצה של דוחות חזותיים מוגדרים מראש של נתוני שימוש בסיסיים ב-API, מכסות ופרטי חיוב במסוף Google Cloud. אתם יכולים להשתמש בדוחות האלה כדי לקבוע את מספר הקריאות ל-API שביצעתם, את מידת הקרבה שלכם למכסות השימוש ב-API ולעקוב אחרי השימוש לחיוב לאורך זמן.
סוגי הדוחות כוללים:
- דוחות שימוש: דוחות על מספר הבקשות שהפרויקט שלכם שולח לממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה שמשויכים לפרויקט.
- דוחות מכסות: דוחות על השימוש במכסות בתרשים שאפשר לקבץ לפי בקשות לדקה. המכסות הקיימות לממשקי API נבחרים מוצגות בטבלאות מתחת לתרשים השימוש במכסות.
- דוחות חיוב: הדוח מציג את העלויות לאורך זמן כתרשים קו מוערם. הצגת השימוש במכסה בחודש הנוכחי, כולל זיכויים שהוחלו לפי שימוש ספציפי, וגם את העלות הצפויה הכוללת לכל החודש הנוכחי.
- דוחות התעניינות: מספקים תובנות עסקיות לגבי האופן שבו משתמשים מקיימים אינטראקציה עם אפליקציות המפות שלכם.
בדוחות סטטוס התשובות והדוחות תוכלו למצוא רשימה מלאה של סטטוסי התשובות וקודי התשובות שמגדירים אם בקשה מופיעה בדוחות Usage, Quota ו-Billing.
אפשר להציג את הדוחות של השימוש, המכסות והחיוב בפלטפורמה של מפות Google באמצעות מסוף Cloud.
דוחות שימוש
השימוש מבוסס על מספר הבקשות שהפרויקט שולח לממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה שמשויכים לפרויקט. הבקשות כוללות בקשות שהצליחו, בקשות שהובילו לשגיאות בשרת ובקשות שהובילו לשגיאות בלקוח. פרטי הכניסה כוללים מפתחות API ומזהי לקוח (לפרויקטים בתוכנית Premium ולפרויקטים שהועברו מתוכנית Premium). פרטים נוספים זמינים בסקירה הכללית על תוכנית Premium ובמידע על השימוש במזהה לקוח.
מדדי השימוש מוצגים בטבלאות (בקשות, שגיאות וזמן אחזור) ובתרשימים (תנועה, שגיאות וזמן אחזור). למטרות מעקב:
כל ממשקי ה-API: אפשר לסנן ולקבץ מדדי שימוש של כל ממשקי ה-API בדרכים הבאות:
- סינון לפי תקופה ו-API.
- הצגת נתוני תנועה, שגיאות וזמן אחזור שמקובצים לפי קוד תגובה, API ופרטי כניסה.
API ספציפי: אפשר לסנן ולאגד מדדי שימוש של API ספציפי בדרכים הבאות:
- סינון לפי תקופת זמן, גרסאות API, פרטי כניסה ושיטות.
- הצגת נתוני התנועה, השגיאות והזמן האחזור שמקובצים לפי קוד התגובה, שיטת ה-API והגרסה, והפרטים האישיים המזהים.
הדף של מרכז הבקרה של השירותים וממשקי ה-API
בלוח הבקרה של ממשקי ה-API והשירותים מוצגת סקירה כללית של מדדי השימוש בכל ממשקי ה-API שהופעלו בפרויקט: ממשקי ה-API של הפלטפורמה של מפות Google וכן ממשקי API ושירותים אחרים.
בדף Dashboard מוצגים שלושה גרפים וטבלה. אפשר לסנן את נתוני השימוש שמוצגים בתרשים ובטבלה על ידי בחירה של תקופת זמן, החל משעה אחת ועד 30 הימים האחרונים.
בתרשים תנועה מוצג השימוש בשאילתות לדקה (QPM) לכל ממשק API.
בתרשים שגיאות מוצג אחוז הבקשות שהובילו לשגיאות לכל ממשק API.
בתרשים Latency מוצג זמן האחזור החציוני של הבקשות לכל API.
מתחת לתרשים מופיעה טבלה עם רשימת ה-API והשירותים המופעלים. 'בקשות' הוא מספר הבקשות (בתקופת הזמן שנבחרה). השגיאות הן מספר הבקשות האלה שהובילו לשגיאות. זמן האחזור (זמן אחזור בינוני ופריסנטיל) הוא זמן האחזור של הבקשות האלה.
כדי לגשת לדף של מרכז הבקרה של השירותים וממשקי ה-API:
- פותחים את הדף Project selector במסוף Cloud:
- בוחרים את הפרויקט הרצוי. מופיע הדף של מרכז הבקרה של השירותים וממשקי ה-API.
אם הדף לא מופיע, לוחצים על לחצן התפריט ואז על APIs & Services.
מידע נוסף זמין במאמר מעקב אחר השימוש ב-API.
דף הסקירה הכללית של מפות Google
בדף סקירה כללית של מפות Google מופיעה טבלה עם רשימת ממשקי ה-API שהופעלו ובקשות השימוש מ-30 הימים האחרונים. הבקשות לפי API מוצגות גם בתרשים. בתרשים החיוב מוצגים החשבונית הנוכחית והשימוש הכולל ב-3 החודשים האחרונים.
כדי לגשת לדף הסקירה הכללית של הפלטפורמה של מפות Google:
- פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:
- בתפריט הימני, לוחצים על סקירה כללית.
הדף 'שירותים וממשקי API של הפלטפורמה של מפות Google'
הדף APIs & Services של מפות Google מכיל רשת של משבצות שמייצגות את ממשקי ה-API, ערכות ה-SDK והשירותים האחרים שזמינים לפרויקט. בכל משבצת אפשר להפעיל או להשבית את השירות על ידי בחירה באפשרות Enable (הפעלה) או Disable (השבתה). בנוסף, אפשר לגשת למידע על פרטי הכניסה, למדדים ולמדריכים למשתמש של ממשקי ה-API המופעלים. אפשר גם להשתמש במסנני הדף כדי להציג שירותים מופעלים או מושבתים וקטגוריות שירות אחרות.
כדי לגשת לדף 'שירותים וממשקי API של הפלטפורמה של מפות Google':
- פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:
- בתפריט הימני, לוחצים על APIs & Services.
הדף 'מדדים' במפות Google
בדף מדדים של מפות Google מוצגים שלושה תרשימים: תנועה, שגיאות וזמן אחזור חציוני. אפשר לקבץ את נתוני השימוש בתרשים לפי סיווג של קוד תגובה, API, שיטת API, פרטי כניסה, פלטפורמה ודומיין.
מתחת לתרשים, בדף Metrics יש טבלה של ממשקי API שמציגה בקשות, שגיאות וזמן אחזור של ממשקי ה-API שבחרתם.
באמצעות התפריט הנפתח של ממשקי ה-API בחלק העליון, ואפשרויות הקיבוץ והסינון שבחלונית השמאלית, תוכלו לקבץ ולסנן את מדדי השימוש המוצגים על ידי בחירת ממשקי API ספציפיים או מרובים, פרטי כניסה, סיווגים של קודי תגובה, סוג פלטפורמה ו/או דומיין. אפשר גם לבחור פרק זמן (משעה אחת ועד 30 הימים האחרונים) ורמת פירוט (לשנייה או ליום) של מדדי השימוש שמוצגים.
בתמונות הבאות מוצגים המסננים Platform ו-Domain ל-API יחיד, כשהאפשרויות Platform ו-Domain מסומנות ברשימה הנפתחת Grouped by:
כדי לגשת לדף המדדים של Google Maps Platform API:
- פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:
- בתפריט הימני, לוחצים על מדדים.
דיווח על פרטי כניסה
אפשר לסנן ולקבץ מדדים לפי פרטי הכניסה ששימשו לטעינת ה-API.
פורמט פרטי הכניסה | משמעות |
---|---|
שם המפתח לדוגמה, 'מפתח לאפליקציה לנייד' |
נעשה שימוש במפתח API כדי לטעון את ה-API באמצעות ?key=... : שמות המפתחות מופיעים במסוף של פלטפורמת מפות Google בקטע Keys & Credentials. |
מספר הפרויקט לדוגמה, 'project_number:123456', כאשר 123456 הוא מספר הפרויקט. |
אם אתם רואים את פרטי הכניסה האלה, יש שתי אפשרויות:
|
תרשימים של קודי תגובה
בתרשים תנועה לפי קוד תגובה ובתרשים שגיאות לפי קוד תגובה, השימוש מחולק לפי סיווג של קודי תגובת 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 | ב-Geolocation API, ההודעה הזו מציינת שהנתונים שהוזנו לא היו מספיקים כדי ליצור הערכה של מיקום. ב-Roads API, ההודעה הזו מציינת שלא ניתן היה להתאים את הקלט לכבישים באופן סביר. זוהי בקשה לחיוב שתצרוך מכסה. |
UNKNOWN_ERROR | 5xx | שגיאת שרת שמציינת שאי אפשר להמשיך בטיפול בבקשה: שגיאה פנימית, עומס יתר בשירות, השירות לא זמין, זמן קצוב פג ועוד. |
1
כדי לשפר את העקביות של הדיווח על קודי שגיאה, אנחנו מעבירים את ממשקי ה-API של פלטפורמת מפות Google:
1) ממעמד 2xx של קוד התגובה ל-HTTP למעמד 4xx עבור מצבי ה-API של מפות Google: DATA_NOT_AVAILABLE , NOT_FOUND , ZERO_RESULTS – status,
2) ממעמד 2xx של קוד התגובה ל-HTTP למעמד 4xx עבור מצבי ה-API של מפות Google: REQUEST_DENIED , OVER_DAILY_LIMIT , OVER_QUERY_LIMIT , dailyLimitExceeded , rateLimitExceeded , userRateLimitExceeded ,
3) ממעמד 2xx של קוד התגובה ל-HTTP למעמד 5xx עבור מצב ה-API של מפות Google: UNKNOWN_ERROR .
תוכלו לראות את שני קודי התגובה במהלך תקופת המעבר. קודי התגובה שמוחזרים בתגובות של Maps API לא משתנים.
כדי לוודא שהעלייה ב-4xx ו/או ב-5xx במדדים של הפלטפורמה של מפות Google קשורה להעברה הזו, בודקים את קוד התגובה המדויק שמספרו עולה ב-Metrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).
|
מידע נוסף על קודי סטטוס והודעות שגיאה זמין במסמכי העזרה של התגובות ל-API הרצוי (לדוגמה, תגובות לגיאוקוד או תגובות למסלול).
פרמטר של פתרונות בפלטפורמה של מפות Google
בפלטפורמה של מפות Google יש סוגים רבים של קוד לדוגמה שיעזרו לכם להתחיל להשתמש בה במהירות. לדוגמה, תוכלו להשתמש ב-Quick Builder במסוף Cloud, לפעול לפי מדריכי ההטמעה של הפתרונות בתחום ולקבל מידע מcodelabs.
כדי להבין את השימוש בפתרונות שלנו ולמצוא דרכים לשיפורם, Google כוללת את פרמטר השאילתה solution_channel
בקריאות ל-API כדי לאסוף מידע על השימוש בקוד לדוגמה:
- פרמטר השאילתה
solution_channel
כלול כברירת מחדל בקוד לדוגמה של הפתרון. - פרמטר השאילתה מחזיר ל-Google ניתוח נתונים על אימוץ הפתרון, כדי לשפר את איכות הפתרון בגרסאות עתידיות.
- כדי לבטל את ההסכמה, מוחקים את הפרמטר של השאילתה
solution_channel
ואת הערך שלו מהקוד לדוגמה. - אין צורך לשמור את הפרמטר. הסרת הפרמטר של השאילתה לא משפיעה על הביצועים.
- פרמטר השאילתה משמש רק לדיווח על שימוש בקוד לדוגמה.
- פרמטר השאילתה נפרד מכל ניתוח ודיווח ספציפיים ל-API. כלומר, הסרת הפרמטר מקובץ הקוד לדוגמה של הפתרון לא משביתה את הדיווח הפנימי של Google Maps JavaScript API.
דוחות מכסות
המכסות קובעות מגבלות על מספר הבקשות שהפרויקט יכול לשלוח לממשקי ה-API של הפלטפורמה של מפות Google. אפשר להגביל את הבקשות בשלוש דרכים: ליום, לדקה ולמשתמש לדקה. רק בקשות שהושלמו ובקשות שגרמו לשגיאות בשרת נספרות במכסה. בקשות שלא עוברות אימות לא נספרות במכסה.
השימוש במכסות מוצג בתרשים בדף Quotas במסוף Cloud, וניתן לקבץ אותו לפי בקשות לדקה. מגבלות המכסות העדכניות לממשקי API נבחרים מוצגות בטבלאות מתחת לתרשים השימוש במכסות.
כדי לקבל את ערך המכסה לדקה לכל מוצר API של GMP, תוכלו להשתמש ב מחשבון הזה.
הדף 'מכסות' במפות 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 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 או טעינת תמונה פנורמית. העלאות מפות זמינות ללא תשלום ולא נספרות במכסה.
כדי לגשת לדף המכסות של הפלטפורמה של מפות Google:
- פותחים את הדף של פלטפורמת מפות Google במסוף Cloud:
- בתפריט הימני, בוחרים באפשרות Quotas.
- בוחרים ממשק API מהרשימה הנפתחת של ממשקי ה-API.
יחידות מיכסה
בטבלה הזו מוצגת יחידת המכסה של ממשקי ה-API של הפלטפורמה של מפות Google.
Google Maps Platform API | יחידת המכסה |
---|---|
מפות | |
SDK של מפות ל-Android | 1 פנורמה |
SDK של מפות ל-iOS | 1 פנורמה |
Map Tiles API | בקשה אחת |
Maps Aerial View API | בקשה אחת |
Maps Static API | בקשה אחת |
Maps JavaScript API | טעינה של מפה אחת |
Street View Static API | בקשה אחת |
Maps Embed API | טעינה של מפה אחת |
Routes | |
Routes API (Compute Routes) | בקשה אחת |
Routes API (Compute Route Matrix) | רכיב אחד (צמד מקור-יעד) |
Directions API | בקשה אחת |
Distance Matrix API | רכיב אחד (צמד מקור-יעד) |
Roads API | בקשה אחת |
Route Optimization API | בקשה אחת |
Navigation SDK ל-Android | יעד אחד |
Navigation SDK ל-iOS | יעד אחד |
מקומות | |
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. מידע נוסף זמין במאמר חיוב.
כדי לגשת לדוחות החיוב:
- פותחים את הדף Project selector במסוף Cloud:
- בוחרים פרויקט.
- לוחצים על לחצן התפריט ואז על Billing.
- אם יש לכם כמה חשבונות לחיוב, בוחרים באפשרות Go to linked billing account כדי לפתוח את הדף Overview של החשבון לחיוב שמקושר.
- בתפריט הימני, בוחרים באפשרות Reports כדי לפתוח את הדף Reports של החיוב בחשבון לחיוב המקושר.
הסבר על המבנה של תרשים הדוח בחיוב
בדוחות החיוב מוצגות העלויות לאורך זמן בתרשים קו מוערם. בתצוגת ברירת המחדל מוצגות העלויות היומיות לפי שימוש ספציפי בחודש הנוכחי, כשהן מקובצות לפי פרויקט (לכל המוצרים), כולל זיכויים שהוחלו לפי שימוש ספציפי, וגם העלות הצפויה הכוללת לכל החודש הנוכחי. כל הקווים בתרשים (והשורות בטבלת הסיכום) תואמים לפרויקט, והם מדורגים לפי גובה העלות בסדר יורד. מידע נוסף על פרשנות התרשים של דוח החיוב
טיפ: ניתוח השימוש והעלות לכל מק"ט
כדי להבין בצורה מדויקת יותר את פרטי מודל התמחור בתשלום לפי שימוש ואת ההשפעה שלו על ההטמעה, כדאי לבדוק את השימוש והעלות לפי מק"ט.
כדי לשנות את תצוגת הדוח כך שתציג פריטים לפי מק"ט:
- בחלונית שמשמאל לתרשים, מרחיבים את המסנן 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 אחד).
מעקב אחר שימוש לכל ערוץ
כדי לעקוב אחרי השימוש בערוצים מספריים, צריך להוסיף את הפרמטר '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.
כדי לסנן את דוח החיוב לפי מק"ט וערוץ
- משתמשים במסנן Group by (קיבוץ לפי) של המק"ט.
- בוחרים את החץ Labels.
- בתפריט הנפתח Key, בוחרים באפשרות goog-maps-channel.
- בוחרים בתפריט הנפתח Value ובוחרים את הערוצים המספריים שרוצים לסנן.
מקבצים לפי המפתח של תווית העלות goog-maps-channel כדי לראות את העלות שנוצרה מכל ערוץ.
אחרי שתטמיעו את נתוני השימוש בערוץ בבקשות שלכם, יכול להיות שיחלוף עיכוב קצר (עד 24 שעות) עד שהנתונים יופיעו בדוח החיוב.
ייצוא נתוני החיוב באמצעות BigQuery
אפשר גם לייצא את נתוני החיוב ל-BigQuery.
הייצוא ל-BigQuery מאפשר לייצא באופן אוטומטי במהלך היום נתוני חיוב מפורטים ב-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:
- יצירה, שינוי וסגירה של חשבון לחיוב ב-Cloud
- שינוי של הגדרות החיוב בפרויקט
- צפייה בדוחות החיוב ובמגמות של עלויות
- הגדרת תקציבים והתראות לתקציבים
- הגבלת השימוש ב-API
סטטוס התגובה ודוחות
בטבלה הבאה מוצגת המיפוי בין סטטוס Maps API, קוד התגובה של HTTP שמוחזר בתשובות של Maps API וסיווג קוד התגובה של HTTP בדוח השימוש. בנוסף, בטבלה מצוין אם הבקשה המתאימה מופיעה בדוחות 'שימוש', 'מכסות' ו'חיוב'.
דוח השימוש במדדים של פלטפורמת מפות Google מספק רמת פירוט של HTTP response code class
. אם אתם צריכים רמת פירוט גבוהה יותר, תוכלו לעיין בקודי סטטוס התשובה שזמינים במעקב אחר השימוש בפלטפורמה של מפות Google.
קודי התגובה שזמינים בתשובות של Maps API | זמין בדוח 'שימוש במסגרת רישיון' | דיווח ל- | |||
---|---|---|---|---|---|
סטטוס של Maps API | קוד תגובת HTTP | סיווג של קוד תגובת HTTP | שימוש | מכסה | חיוב |
אישור | 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 עבור מצבי 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 קשורה להעברה הזו, בודקים את קוד התגובה המדויק שמספרו עולה בMetrics Explorer (מידע נוסף על השימוש ב-Google Cloud Monitoring לפלטפורמה של מפות Google).
|
דוחות על היקף המעורבות של הצופים
מדדים עסקיים
פלטפורמת מפות Google מספקת תובנות לגבי האופן שבו המשתמשים מקיימים אינטראקציה עם המפות שלכם. התובנות האלה כוללות מדדי מעורבות מרכזיים כמו צפיות במפה או אינטראקציות עם נקודת עניין. אתם יכולים לנתח את התובנות האלה כדי לזהות מיקומים פופולריים לפרסום ולשיווק, או כדי לבצע אופטימיזציה של חוויית המשתמש.
יכולות הדיווח של תובנות עסקיות כוללות:
- הצגת תמונת מצב ברמה גבוהה של תובנות עסקיות כדי לראות מגמות עיקריות בתובנות העסקיות במבט מהיר
- ניתוח מעמיק של מדד ספציפי במסוף כדי להבין את המדדים לעומק
- ייצוא מדדים לקובץ CSV כדי שתוכלו לנתח את נתוני התובנות העסקיות בכלי הניתוח העסקי המועדף עליכם
מדדי המעורבות הזמינים כוללים:
- תצוגות מפה: מעקב אחרי תצוגות במפה שנובעות מתנועות פנורמיות, שינוי מרחק התצוגה או הטיה. התצוגות במפה מחושבות לפי מיקוד על בסיס שבועי (מיום ראשון עד יום שבת לפי שעון החוף המערבי). נתונים חדשים מתפרסמים מדי שבוע ביום רביעי הראשון לאחר תקופת המעקב.
בעלי פרויקטים ומשתמשים עם התפקיד צפייה בניתוח נתונים של מפות Google יכולים לראות תובנות עסקיות בדף המדדים במסוף Cloud. צריך להפעיל את Maps JavaScript API בפרויקט.
אתם יכולים לנתח מדדי התעניינות ישירות במסוף באמצעות התכונות 'סינון' ו'קיבוץ לפי', כדי להתעמק במדדים בפירוט רב יותר. לדוגמה, אפשר לסנן לפי אזור ספציפי כדי לבדוק את המגמות של צפיות במפה רק במספרי מיקוד באזור הזה. מצד שני, יכול להיות שתרצו לקבץ לפי אזור ספציפי כדי לצבור אינטראקציות בתוך האזור הזה.
המשתמשים יכולים לייצא את כל קבוצת הנתונים או תצוגה מסוננת לקובץ CSV כדי לנתח אותם לעומק בכלי הניתוח העסקי המועדף עליהם. אפשר להוריד עד 90 ימים בכל פעם, והורדות של יותר מ-60,000 תאים יקוצצו. ייצוא נתוני צפיות במפה לקובץ CSV עשוי להימשך כמה דקות, בהתאם לטווח הזמן שנבחר.
המדדים של תובנות העסק אנונימיים, ולכן הם משקפים רק מגמות כלליות במעורבות עם המפות שלכם. ייתכן שמספרים נמוכים יעוגלו לאפס, וייתכן שתרומות של ערכים חריגים יצומצמו.
אתם יכולים לשלוט בגישה לתובנות העסקיות של הפרויקט ב-Cloud במסוף Google Cloud באמצעות ההרשאה Maps Analytics. הבעלים של הפרויקט מקבלים את ההרשאה הזו כברירת מחדל, והם יכולים להקצות גישה למשתמשים אחרים לפי הצורך.
אין להשתמש בתובנות עסקיות כדי להעריך את עלויות השימוש. מידע נוסף על השימוש זמין בדוחות השימוש.