הדיווח בפלטפורמה של מפות Google מספק קבוצה של רכיבים חזותיים מוגדרים מראש דוחות על שימוש בסיסי ב-API, מכסות ונתוני חיוב מסוף Google Cloud. צריך להשתמש בדוחות האלה כדי לזהות את מספר ה-API השיחות שביצעת, עד כמה אתה קרוב למיצוי מכסות השימוש ב-API, ומעקב בשימוש שלכם בחיוב לאורך זמן.
סוגי הדוחות:
- דוחות שימוש: מדווח על מספר הבקשות שהפרויקט שלכם שלח. ממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי כניסה שמשויכים לפרויקט שלכם.
- דוחות מכסות: שימוש במכסות בדוחות בתרשימים שאפשר לקבץ בבקשות לדקה. המגבלות הנוכחיות במכסות של ממשקי ה-API שנבחרו מוצגות בטבלאות שמתחת לתרשימי השימוש במכסות.
- דוחות חיוב: דיווח על עלויות לאורך זמן כתרשים קו מוערם. הצגה של ניצול המכסה בחודש הנוכחי, כולל זיכויים שהוחלו לפי שימוש ספציפי, וכן את סך כל הזיכויים העלות הצפויה לכל החודש הנוכחי.
- דוחות מעורבות: מספקים תובנות עסקיות לגבי האינטראקציות של המשתמשים עם האפליקציות שלכם למפות.
לרשימה מלאה של הסטטוסים של התגובות וקודי התגובות שמגדירים אם בקשה מופיעה בשדות Usage, Quota ו/או דוחות של חיוב, ראו הסטטוס והדוחות של התשובות.
לצפות בדוחות על שימוש, מכסות וחיובים בפלטפורמה של מפות Google באמצעות מסוף Cloud.
דוחות שימוש
השימוש מבוסס על מספר הבקשות שהפרויקט שלח ממשקי ה-API של הפלטפורמה של מפות Google באמצעות פרטי הכניסה המשויכים אל פרויקט. הבקשות כוללות בקשות שבוצעו בהצלחה, בקשות שמובילות לשרת ובקשות שגורמות לשגיאות בצד הלקוח. פרטי הכניסה כוללים מפתחות API ומזהי לקוח (לפרויקטים של תוכנית Premium ולפרויקטים של תוכנית Premium שהועברו). לפרטים נוספים אפשר לעיין בסקירה כללית של תוכנית הפרימיום וב מידע על השימוש במזהה לקוח.
מדדי השימוש מוצגים בטבלאות (בקשות, שגיאות וזמן אחזור) ובתרשימים (תנועה, שגיאות וזמן אחזור). למטרות מעקב:
כל ממשקי ה-API: תוכלו לסנן ולקבץ את מדדי השימוש לכל ממשקי ה-API דרכים:
- סינון לפי תקופה ו-API.
- להציג תנועה, שגיאות וזמן אחזור בקיבוץ לפי קוד תגובה, API ו פרטי כניסה לחשבון.
API ספציפי: אפשר לסנן ולקבץ את מדדי השימוש לפי ממשק API ספציפי. בדרכים האלה:
- סינון לפי תקופה, גרסאות API, פרטי כניסה ושיטות.
- הצגת התנועה, השגיאות וזמן האחזור בקיבוץ לפי קוד תגובה, שיטת API ואת הגרסה, ופרטי הכניסה.
ממשקי API דף מרכז הבקרה של השירותים
ממשקי ה-API Services (שירותים) מרכז הבקרה מספקת סקירה כללית של מדדי השימוש בכל ממשקי ה-API מופעלת עבור הפרויקט שלך: ממשקי ה-API של הפלטפורמה של מפות Google וכן ממשקי API ושירותים.
הדף מרכז שליטה כולל שלושה תרשימים וטבלה. אפשר לסנן את השימוש שמוצגות בתרשימים ובטבלאות על ידי בחירת תקופת זמן משעה אחת עד 30 הימים האחרונים.
בתרשים התנועה מוצג השימוש בשאילתות לדקה (QPM) לכל API.
בתרשים שגיאות מוצג אחוז הבקשות שהובילו לשגיאות. לכל API.
בתרשים זמן אחזור מוצג זמן האחזור החציוני של הבקשות לכל API.
מתחת לתרשימים מוצגת טבלה עם פירוט של ממשקי ה-API והשירותים שמופעלים. הבקשות הן מספר הבקשות (בתקופת הזמן שנבחרה). השגיאות הן מספר הבקשות שהובילו לשגיאות. זמן האחזור (זמן אחזור בינוני ואחוזון) הוא זמן האחזור של הבקשות האלה.
כדי לגשת לממשקי ה-API דף מרכז השליטה של השירותים:
- פותחים את הדף 'בורר פרויקטים' במסוף Cloud:
- בוחרים את הפרויקט הרצוי. ממשקי ה-API יופיע הדף 'מרכז השליטה של השירותים'.
אם הדף לא מופיע, צריך ללחוץ על לחצן התפריטובוחרים באפשרות APIs & שירותים.
למידע נוסף, ראו מעקב אחר השימוש ב-API.
דף הסקירה הכללית של מפות Google
מפות Google הדף סקירה כללית הדוח כולל טבלה עם פירוט של ממשקי ה-API שהופעלו ובקשות השימוש ב-30 הימים האחרונים. בקשות לפי API מוצגות גם בפורמט של תרשים. בתרשים החיוב מוצג החיוב הנוכחי ואת השימוש הכולל ב-3 החודשים האחרונים.
כדי לגשת לדף 'סקירה כללית של הפלטפורמה של מפות Google':
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני, לוחצים על סקירה כללית.
ממשקי API של הפלטפורמה של מפות Google דף השירותים
מפות Google ממשקי API הדף Services (שירותים) מכיל רשת של משבצות שמייצגות את ממשקי ה-API, ערכות ה-SDK ושירותים אחרים זמינים לפרויקט שלכם. בתוך כל משבצת, אפשר להפעיל או להשבית אותה בוחרים באפשרות Enable (הפעלה) או Disable (השבתה), ולאחר מכן אפשר לגשת לפרטי הכניסה. מידע, מדדים ומדריכים למשתמש שמופעלים בו ממשקי API. אפשר גם להשתמש במסננים של הדפים כדי להציג שירותים מופעלים או מושבתים וקטגוריות שירות אחרות.
כדי לגשת לממשקי ה-API של הפלטפורמה של מפות Google דף השירותים:
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני לוחצים על APIs & שירותים.
דף המדדים במפות Google
מפות Google הדף Metrics מציג שלושה תרשימים: תנועה, שגיאות וזמן אחזור חציוני. אפשר לקבץ את נתוני השימוש בתרשימים לפי מחלקה של קוד תגובה, API, שיטת API, פרטי כניסה, פלטפורמה ודומיין.
מתחת לתרשימים, הדף Metrics כולל טבלת ממשקי API שמציגה בקשות, שגיאות וזמן אחזור לממשקי ה-API שבחרת.
באמצעות התפריט הנפתח של ה-API שבחלק העליון, ואפשרויות הקיבוץ והסינון בחלונית השמאלית, אפשר לקבץ ולסנן את מדדי השימוש המוצגים על ידי בחירת ממשקי API ספציפיים או מרובים, פרטי כניסה, מחלקות של קוד תגובה, סוג הפלטפורמה ו/או הדומיין. אפשר גם לבחור תקופת זמן. (משעה אחת עד 30 הימים האחרונים) ורמת פירוט (לשנייה או ליום) למדדי השימוש המוצגים.
בתמונות הבאות מוצגים מסנני פלטפורמה ודומיין בשביל API יחיד כאשר האפשרות 'קיבוץ לפי פלטפורמה' ו'דומיין' מסומנת ברשימה הנפתחת Grouped by:
כדי לגשת לדף 'מדדי ה-API של הפלטפורמה של מפות Google':
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני, לוחצים על מדדים.
דיווח על פרטי כניסה
אפשר לסנן ולקבץ מדדים לפי פרטי הכניסה ששימשו לטעינת API.
הפורמט של פרטי הכניסה | משמעות |
---|---|
שם מפתח לדוגמה, 'מפתח אפליקציה לנייד' |
נעשה שימוש במפתח API כדי לטעון את ה-API באמצעות
?key=... : השמות של המפתחות מופיעים בפלטפורמה של מפות Google
המסוף בקטע Keys & פרטי כניסה. |
מספר הפרויקט לדוגמה, 'project_number:123456', כאשר 123456 הוא מספר הפרויקט. |
יש שתי אפשרויות לראות את פרטי הכניסה האלה:
|
תרשימים של קודי תגובה
התרשימים של תנועה לפי קוד תגובה ושגיאה לפי קוד תגובה בשימוש במחלקה של קוד תגובת HTTP. בטבלה הזו מוצג המיפוי בין סטטוס התגובה של ה-API של הפלטפורמה של מפות Google וסיווג קוד תגובת HTTP:
סטטוס ה-API של מפות Google | סיווג של קוד תגובת HTTP – דוח שימוש (2xx, 3xx, 4xx, 5xx) |
הערות |
---|---|---|
אישור | 2xx | התשובה הצליחה. זוהי בקשה לחיוב והיא תנצל מכסה. |
אישור | 3xx | התשובה הצליחה. זוהי בקשה לחיוב והיא תנצל מכסה. לדוגמה, תמונת מקום בקשות שבוצעו בהצלחה מחזירות הפניה אוטומטית מסוג 302 לתמונה שאליה מתבצעת ההפניה. |
DATA_NOT_AVAILABLE | 4xx(1) | תגובה מוצלחת שמציינת שאין נתונים זמינים עבור
של מיקומי הקלט. זוהי בקשה לחיוב והיא תנצל מכסה. |
ZERO_RESULTS | 4xx(1) | תשובה מוצלחת לא החזירה תוצאה. זוהי בקשה לחיוב והיא תנצל מכסה. |
NOT_FOUND | 4xx(1) | עבור
Directions API,
ההודעה הזו מציינת שלפחות אחד מהמיקומים שצוינו ב-
לא ניתן היה לבצע קידוד גיאוגרפי של הבקשה: המקור, היעד או נקודות העצירה של הבקשה. עבור Places API הודעה זו מציינת שהמיקום המקושר (place_id) לא היה שנמצא במסד הנתונים של 'מקומות'. זוהי בקשה לחיוב והיא תנצל מכסה. |
INVALID_REQUEST (ערך פרמטר לא חוקי), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED ואחרים. |
4xx | שגיאה שנגרמה בגלל ערך פרמטר לא חוקי. בדיקת ה-API
כדי לקבל פרטים נוספים. זוהי בקשה לחיוב והיא תנצל מכסה. |
REQUEST_DENIED | 4xx | שגיאת לקוח שנגרמת משגיאת אימות, משגיאת גישה ועוד. לפרטים נוספים, אפשר לעיין בתשובה שהתקבלה מה-API. |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, Resource_EXHAUSTED, חרגת ממגבלת התעריף, חריגה יומית, userRateLimitExceeded |
4xx | שגיאת לקוח שנגרמה עקב בקשות רבות מדי לכל פרק זמן מותר. אני רוצה לנסות שוב את הבקשה במועד מאוחר יותר. לפרטים נוספים, אפשר לעיין בתשובה שהתקבלה מה-API. |
INVALID_REQUEST (פרמטר לא חוקי או חסר, בקשה) שגיאת ניתוח או אימות) | 4xx | שגיאת לקוח שנגרמה עקב בקשה לא חוקית. מידע נוסף מופיע בתשובה מה-API פרטים. |
NOT_FOUND (404) | 4xx | עבור
Geolocation API,
ההודעה הזאת מציינת שערכי הקלט לא מספיקים
הערכת מיקום. ב-Roads API, ההודעה הזאת מציינת שלא ניתן היה לצלם את הקלט באופן סביר לכבישים. זוהי בקשה לחיוב והיא תנצל מכסה. |
UNKNOWN_ERROR | 5xx | שגיאת שרת שמציינת שלא ניתן להמשיך בבקשה: פנימית שגיאה, שירות עמוס, לא זמין, פסק זמן ועוד. |
1
כדי לשפר את העקביות בדיווח על קודי שגיאה, הפלטפורמה של מפות Google
ממשקי ה-API בתהליך מיגרציה:
1) מסיווג של קוד תגובת HTTP 2xx אל 4xx עבור
סטטוסים ב-API של מפות Google: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - status,
2) מסיווג של קוד תגובת HTTP 2xx אל 4xx עבור
סטטוסים ב-API של מפות Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded ,
3) מסיווג של קוד תגובת HTTP 2xx עד 5xx עבור
הסטטוס של מפות Google API: UNKNOWN_ERROR .
ניתן לראות את שני קודי התגובה במהלך המעבר
של התקופה. קודי תגובה שמוחזרים בתשובות מה-API של מפות Google לא משתנים.
צריך לאשר שעלייה ב-4xx ו/או ב-5xx ב-
מדדי הפלטפורמה של מפות Google
קשורה להעברה זו על ידי בדיקה איזה קוד תגובה מדויק גדל
Metrics Explorer
(למידע נוסף על השימוש
Google Cloud Monitoring לפלטפורמה של מפות Google).
|
מידע נוסף על קודי סטטוס והודעות שגיאה זמין בתשובה של ה-API הרצוי (לדוגמה, קואורדינטות של קידוד גיאוגרפי או תשובות למסלול).
פרמטר של פתרונות הפלטפורמה של מפות Google
הפלטפורמה של מפות Google מספקת סוגים רבים של קוד לדוגמה כדי לעזור לכם להתחיל והם פועלים במהירות. לדוגמה, אפשר להשתמש ב- פיתוח מהיר במסוף Cloud, לפעול לפי הפתרונות המקובלים בתחום מדריכים להטמעה, וללמוד מהם Codelabs.
כדי להבין את השימוש ואת הדרכים לשיפור הפתרונות שלנו, Google כוללת את
פרמטר של שאילתת solution_channel
בקריאות ל-API כדי לאסוף מידע על שימוש בקוד לדוגמה:
- פרמטר השאילתה
solution_channel
נכלל כברירת מחדל בקוד לדוגמה של הפתרון. - פרמטר השאילתה מחזיר ל-Google את ניתוח הנתונים לגבי אימוץ הפתרון כדי לשפר את איכות הפתרונות באיטרציות עתידיות.
- אפשר לבטל את ההסכמה על ידי מחיקת השאילתה
solution_channel
ואת הערך שלו מקוד לדוגמה. - לא צריך לשמור את הפרמטר. הסרת השאילתה מתבצעת אינו משפיע על הביצועים.
- פרמטר השאילתה משמש רק לצורך דיווח לדוגמה על השימוש בקוד.
- פרמטר השאילתה נפרד מכל ניתוח נתונים ספציפי ל-API דיווח. כלומר, הסרת הפרמטר מהקוד לדוגמה של הפתרון לא משביתה דיווח פנימי של Maps JavaScript API.
דוחות מכסות
מכסות מגדירות מגבלות על מספר הבקשות שהפרויקט יכול לשלוח ממשקי API של הפלטפורמה של מפות Google. אפשר להגביל בקשות בשלוש דרכים: ליום, לדקה ולמשתמש לדקה. רק בקשות שבוצעו בהצלחה בקשות שגורמות לשגיאות בחיבור לשרת נספרות כחלק מהמכסה. בקשות אימות נכשל לא ייחשב כחלק מהמכסה.
המכסות מוצגות בתרשימים בדף Quotas במסוף Cloud. ואפשר לקבץ אותם בבקשות לדקה. המגבלות הנוכחיות במכסות על ממשקי ה-API שנבחרו מוצגים בטבלאות מתחת למכסה בשימוש גרפים.
כדי לקבל את ערך המכסה לדקה של מוצר כלשהו ב-GMP API, צריך להשתמש ומחשבון.
דף המכסות במפות Google
מפות Google הדף Quotas מציג את מגבלות המכסה ואת צריכת המכסות לממשק ה-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 ו-liftion API), אבל יש כמה יוצאים מן הכלל:
- ב-Destination Matrix API, יחידת המכסה היא רכיב שהוא צמד מוצא-יעד.
- ב-Maps JavaScript API, יחידת המכסה היא טעינת מפה.
- ב-SDK של מפות ל-Android וב-SDK של מפות ל-iOS: יחידת המכסה היא בקשת Street View או פנורמה טעינה. טעינות של מפות זמינות ללא תשלום והן לא נכללות במכסה.
כדי לגשת לדף המכסות בפלטפורמה של מפות Google:
- פותחים את הדף 'הפלטפורמה של מפות Google' במסוף Cloud:
- בתפריט הימני, בוחרים באפשרות 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 | בקשה אחת |
Route Optimization 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:
- בוחרים פרויקט.
- לוחצים על לחצן התפריט
ובוחרים באפשרות חיוב.
- אם יש לכם כמה חשבונות לחיוב, לוחצים על מעבר לחשבון החיוב המקושר. כדי לפתוח את הדף Overview של החשבון לחיוב שמקושר לחשבון.
- בתפריט הימני, בוחרים באפשרות דוחות כדי לפתוח את דף דוחות החיוב לחשבון המקושר לחיוב.
הסבר על המבנה של תרשים דוח החיוב
בדוחות החיוב מוצגת העלות לאורך זמן כתרשים קו מוערם. ברירת המחדל התצוגה מציגה את העלויות היומיות לפי שימוש ספציפי בחודש הנוכחי, כשהן מקובצות לפי פרויקט (לכל המוצרים), כולל זיכויים שהוחלו לפי שימוש ספציפי, וגם את העלות הצפויה הכוללת לכל החודש הנוכחי. כל אחד הקו בתרשים (והשורה בטבלת הסיכום) תואמים לפרויקט, בדירוג מהגבוה לנמוך. למידע נוסף על פירוש התרשים של דוח החיוב.
![צילום מסך של דוח החיוב, שבו מוצגים תרשים וטבלה באמצעות
תצוגה קבועה מראש עבור ברירת המחדל](https://cloud.google.com/billing/docs/images/billing-reports1.png?authuser=5&hl=he)
טיפ: ניתוח השימוש והעלות לכל מק"ט
כדי להבין בצורה מדויקת יותר את פרטי מודל התמחור של תשלום לפי שימוש כדי להבין איך זה משפיע על ההטמעה, צריך לבחון את השימוש והעלות לפי מק"ט.
![דוח החיוב מקובצים לפי מק"ט](https://developers.google.cn/static/maps/reporting-and-monitoring/images/billing-report-table-by-sku.png?authuser=5&hl=he)
![צילום מסך של המסננים של דוח החיוב](https://developers.google.cn/static/maps/reporting-and-monitoring/images/billing-report-filters-sku.png?authuser=5&hl=he)
כדי לשנות את תצוגת הדוח כך שיוצגו פריטים לפי מק"ט:
- בחלונית שמשמאל לתרשים, מרחיבים את המסנן Group by.
- בוחרים באפשרות מק"ט.
המסננים הזמינים האחרים של דוחות החיוב כוללים את המסננים טווח זמן, פרויקטים, מוצרים, מק"טים ומיקומים שמאפשרים לסנן לפי כאשר בקשות ה-API מגיעות מ-.
כדי לסווג את מקור השימוש שלך בנוסף למוצר, חיוב קבוצתי לפי אחד מהערכים שצוינו. שלושת המפתחות שקשורים ממשקי ה-API של הפלטפורמה של מפות Google הם goog-maps-api-key-suffix (ארבעת החודשים האחרונים) תווים של מפתח API), goog-maps-platform-type (הפלטפורמה: Android, iOS, JavaScript או שירות אינטרנט), ו-goog-maps-channel (הגדרת מספר משאילתת API). עוד מידע על סינון וקיבוץ.
אפשר לשנות את תצוגת התרשים כך שלא תכלול זיכויים ספציפיים לשימוש על ידי ביטול הסימון את תיבת הסימון Include credit in cost (הכללה של זיכויים בעלות) בחלונית השמאלית.
מעקב אחרי הצריכה והגבלה
כדי לעזור לכם לתכנן את התקציב ולשלוט בעלויות, תוכלו לבצע את הפעולות הבאות:
- הגדירו התראת תקציב, לעקוב אחרי האופן שבו ההוצאה שלכם גדלה לסכום מסוים. הגדרת תקציב אינה מגבילה את השימוש ב-API, היא מתריעה רק כאשר סכום ההוצאה שלכם מתקרב בסכום שצוין.
להגביל את השימוש היומי ב-API, כדי לנהל את עלות השימוש בממשקי API שניתנים לחיוב. על ידי הגדרת מכסות לבקשות לכל יום, תוכלו להגביל את ההוצאה. משתמשים במשוואה פשוטה כדי לקבוע תלויה בסכום שברצונך להוציא. מוצרים לדוגמה: (הוצאה חודשית / מחיר לכל מק"ט) חלקי 30 = מכסה ליום (לממשק API אחד).
מעקב אחר שימוש בכל ערוץ
כדי לעקוב אחר השימוש באמצעות ערוצים מספריים, עליך להוסיף את ה'ערוץ' פרמטר לבקשות ה-API שלכם. ערכי הערוצים הקבילים היחידים הם מספרים בין 0-999. הנה כמה דוגמאות:
- ממשק API של Geocoding Web Service
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
- API של מפות Google ל-JavaScript
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
כדאי לעקוב אחרי השימוש בערוץ ישירות בדוח החיוב. הערוצים ישתקפו בקטע תוויות כמפתח goog-maps-channel.
![סינון לפי תוויות](https://developers.google.cn/static/maps/reporting-and-monitoring/images/billing-report-filter-channel.png?authuser=5&hl=he)
כדי לסנן את דוח החיוב לפי מק"ט וערוץ
- משתמשים במסנן 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:
- יצירה, שינוי וסגירה של חשבון לחיוב ב-Cloud
- שינוי הגדרות החיוב של פרויקט
- צפייה בדוחות החיוב ובמגמות של עלויות
- הגדרת תקציבים והתראות לגבי תקציבים
- הגבלת השימוש ב-API
סטטוס התגובה והדוחות
בטבלה הבאה מוצג מיפוי בין הסטטוס של Maps API, קוד תגובת HTTP שמוחזר בתשובות מה-API של מפות Google ובסיווג של קוד תגובת HTTP בדוח השימוש, ואז מציין אם הבקשה התואמת מופיעה בדוחות 'שימוש', 'מכסה' ו'חיוב'.
דוח השימוש במדדי הפלטפורמה של מפות Google
מספק רמת פירוט של HTTP response code class
. אם אתם צריכים רמה גבוהה יותר של
רמת פירוט, ראו קודי סטטוס של תשובות
זמין ב
מעקב אחרי השימוש בפלטפורמה של מפות Google.
קודי תגובה שזמינים בתשובות מה-API של מפות Google | זמין בדוח השימוש | דיווח ל | |||
---|---|---|---|---|---|
סטטוס ה-API של מפות Google | קוד תגובת 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, חריגה יומית, חריגה ממגבלת הקצב, userRateLimitExceeded |
200, 403, 429 |
4xx1 | כן | לא | לא |
UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | כן | כן | לא |
1
כדי לשפר את העקביות בדיווח על קודי שגיאה, הפלטפורמה של מפות Google
ממשקי ה-API בתהליך מיגרציה:
1) מסיווג של קוד תגובת HTTP 2xx אל 4xx עבור
סטטוסים ב-API של מפות Google: DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - status,
2) מסיווג של קוד תגובת HTTP 2xx אל 4xx עבור
סטטוסים ב-API של מפות Google: REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded ,
3) מסיווג של קוד תגובת HTTP 2xx עד 5xx עבור
הסטטוס של מפות Google API: UNKNOWN_ERROR .
ניתן לראות את שני קודי התגובה במהלך המעבר
של התקופה. קודי תגובה שמוחזרים בתשובות מה-API של מפות Google לא משתנים.
צריך לאשר שעלייה ב-4xx ו/או ב-5xx ב-
מדדי הפלטפורמה של מפות Google
קשורה להעברה זו על ידי בדיקה איזה קוד תגובה מדויק גדל
Metrics Explorer
(למידע נוסף על השימוש
Google Cloud Monitoring לפלטפורמה של מפות Google).
|
דוחות על היקף המעורבות של הצופים
מדדים עסקיים
הפלטפורמה של מפות Google מספקת לכם תובנות על האינטראקציה של המשתמשים עם המפות שלכם. התובנות האלה כוללות מדדי התעניינות עיקריים כמו צפיות במפה או אינטראקציות עם נקודת עניין. אפשר לנתח את התובנות האלה כדי לגלות מיקומים פופולריים לצורכי פרסום ושיווק, או כדי לבצע אופטימיזציה של חוויית המשתמש.
יכולות הדיווח של תובנות עסקיות כוללות:
- הצגת תמונת מצב כללית של תובנות עסקיות כדי לראות בקצרה מגמות מרכזיות בתובנות עסקיות
- ניתוח נתונים של מדד ספציפי במסוף כדי להתעמק בהבנה של המדדים בצורה מפורטת יותר
- ייצוא מדדים לקובץ CSV כדי לנתח את נתוני התובנות העסקיות בכלי המועדף עליכם לניתוח עסקי
מדדי המעורבות הזמינים כוללים:
- צפיות במפה: מעקב אחר צפיות במפה כתוצאה מהזזה, משינוי מרחק התצוגה או מהטיות. צפיות במפה מחושבות לפי מיקוד על בסיס שבועי (ראשון עד שבת, לפי שעון החוף המערבי של ארה"ב). נתונים חדשים מתפרסמים מדי שבוע ביום רביעי הראשון לאחר תקופת התצפית.
המשתמשים יכולים לצפות בתובנות עסקיות בדף המדדים במסוף Cloud. חובה על הפרויקט להפעיל את Maps JavaScript API.
אפשר לנתח את מדדי ההתעניינות ישירות במסוף בעזרת היכולות 'סינון' ו'קיבוץ לפי', כדי להתעמק במדדים בצורה מפורטת יותר. לדוגמה, תוכלו לסנן לפי אזור ספציפי כדי לראות את המגמות של תצוגות המפה רק במיקודים באותו אזור. מצד שני, יכול להיות שתרצו לקבץ לפי אזור ספציפי כדי לצבור אינטראקציות בתוך אותו אזור.
המשתמשים יכולים לייצא את כל קבוצת הנתונים או תצוגה מסוננת לקובץ 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 ימים.