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

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

הדיווח בפלטפורמה של מפות 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 למעקב

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

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

אם הדף לא מופיע, צריך ללחוץ על לחצן התפריט ובוחרים באפשרות APIs & שירותים.

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

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

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

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

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

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

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

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

API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

התרשימים של תנועה לפי קוד תגובה ושגיאה לפי קוד תגובה בשימוש במחלקה של קוד תגובת HTTP. בטבלה הזו מוצג המיפוי בין סטטוס התגובה של ה-API של הפלטפורמה של מפות Google וסיווג קוד תגובת 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) לא היה שנמצא במסד הנתונים של 'מקומות'. זוהי בקשה לחיוב והיא תנצל מכסה.
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	שגיאת שרת שמציינת שלא ניתן להמשיך בבקשה: פנימית שגיאה, שירות עמוס, לא זמין, פסק זמן ועוד.
¹ כדי לשפר את העקביות בדיווח על קודי שגיאה, הפלטפורמה של מפות 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 הדף Quotas במסוף 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	בקשה אחת
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 של החשבון לחיוב שמקושר לחשבון.
בתפריט הימני, בוחרים באפשרות דוחות כדי לפתוח את דף דוחות החיוב לחשבון המקושר לחיוב.

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

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

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

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

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

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

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

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

בחלונית שמשמאל לתרשים, מרחיבים את המסנן 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 שניתנים לחיוב, לכן צריך לבצע התאמות את המשוואה לפי הצורך. חשוב לזכור, פלטפורמה של מפות Google בשווי 200 דולר ארה"ב הקרדיט זמין בכל חודש, ולכן חשוב להביא את זה בחשבון בחישוב.

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

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

סינון לפי תוויות — **איור 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 שמוחזר בתשובות מה-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	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, חריגה יומית, חריגה ממגבלת הקצב, userRateLimitExceeded	200, 403, 429	4xx¹	כן	לא	לא
UNKNOWN_ERROR	200, 500, 503	5xx¹	כן	כן	לא
¹ כדי לשפר את העקביות בדיווח על קודי שגיאה, הפלטפורמה של מפות 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 ימים.