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

שאלות נפוצות בנושא הפלטפורמה של מפות Google

תחילת העבודה

מהי הפלטפורמה של מפות Google?

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

מפות Google:

מסלולים:

מקומות:

סביבה:

איך מתחילים לעבוד עם הפלטפורמה של מפות Google?

כדאי לעיין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.

איזה API צריך?

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

איך מתחילים להשתמש בממשקי ה-API באתר?

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

באילו מדינות אפשר למצוא את הפלטפורמה של מפות Google?

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

ראו גם:

איך אפשר להציג מוצרים של הפלטפורמה של מפות Google שהיא לא אנגלית?
באילו מדינות מוצגים מסלולי תחבורה ציבורית זמינים?

אפשר להוסיף את מפות Google לאתר בלי להשתמש במוצרים של הפלטפורמה של מפות Google?

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

איך אפשר לספק אפליקציות של מפות Google במכשירים ניידים?

כדי לשלב מפות באפליקציה ל-Android, SDK של מפות ל-Android.

כדי לשלב מפות באפליקציה מקורית של iOS, Maps SDK ל-iOS.

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

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

אילו דפדפני אינטרנט משמשים את Maps JavaScript API תמיכה ב-Maps Embed API?

התמיכה של Maps JavaScript API ושל Maps Embed API דפדפני האינטרנט הבאים:

מחשב

הגרסה הנוכחית של Microsoft Edge (Windows), לא כולל מצב IE.
שתי הגרסאות היציבות והעדכניות ביותר של Firefox (Windows , macOS ו-Linux).
שתי הגרסאות היציבות והעדכניות ביותר של Chrome (Windows , macOS ו-Linux).
שתי הגרסאות היציבות האחרונות והעדכניות ביותר של Safari (macOS).

Android

הגרסה הנוכחית של Chrome ב-Android מגרסה 4.1 ואילך.
Chrome WebView ב-Android מגרסה 4.4 ואילך.

iOS

Mobile Safari בגרסה הנוכחית ובגרסה הראשית הקודמת של iOS.
UIWebView ו-WKWebView בגרסה הנוכחית ובגרסה הראשית הקודמת של iOS.
הגרסה הנוכחית של Chrome ל-iOS.

האם ניתן להדפיס מפות מתוך Maps JavaScript API?

אין תמיכה בהדפסה מ-API JavaScript של מפות Google. הסיבה לכך היא שהדפסה התמיכה אינה עקבית בדפדפנים נפוצים.

איך אפשר לקבל התראות על שינויים במוצרי הפלטפורמה של מפות Google?

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

איך אפשר לפנות לתמיכה הטכנית?

למידע נוסף, ראו תמיכה ומשאבים בפלטפורמה של מפות Google על אפשרויות התמיכה הזמינות.

מתי אפשר לקבל תמיכה טכנית?

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

איך אפשר לשחזר את הגישה לחשבון Google?

אם איבדת את הגישה לחשבון Google (למשל, joe@mycompany.com או joe@gmail.com), תוכלו לנסות שחזור הגישה לחשבון על ידי אחזור או איפוס הסיסמה. נכנסים אל איך משחזרים את חשבון Google או בנושא Gmail במרכז העזרה של חשבון Google.

הערה: כדי לשחזר את הגישה לחשבון G Suite, צריך לבקש אדמין בארגון שיש לו ביטול מחיקה של החשבון.

איך אפשר לשחזר את הגישה לפרויקט ספציפי?

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

אם יש לכם גישה לחשבון Google שמשויך לפרויקט:

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

אם אין לכם גישה לחשבון Google שמשויך לפרויקט:

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

האם אפשר להשתמש ב-SDK של מפות ומקומות ל-iOS במחשבי Mac מבוססי-זרוע?

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

הסבר על התנאים וההגבלות

מהם התנאים וההגבלות של מוצרי הפלטפורמה של מפות Google?

התנאים וההגבלות של הפלטפורמה של מפות Google זמינים בכתובת:

https://cloud.google.com/maps-platform/terms

האם האתר שלי עומד בתנאים ובהגבלות של הפלטפורמה של מפות Google?

אפשר להשתמש בפלטפורמה של מפות Google בתוך האפליקציות כל עוד האתר עומד בתנאים ובהגבלות של הפלטפורמה של מפות Google.

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

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

האם אפשר לגשת ישירות לקטעי המפה ולצילומי לוויין?

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

אפשר להשתמש במוצרי הפלטפורמה של מפות Google למעקב אחר אפליקציות?

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

אפשר להשתמש במפות Google באפליקציה שאינה אינטרנט?

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

יש תמיכה ב-JavaScript API של מפות Google רק כשמריצים אותו ב- אחת מ- בדפדפנים נתמכים.

האם אפשר להשתמש במוצרי הפלטפורמה של מפות Google באתר שמוגן באמצעות סיסמה?

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

האם אפשר ליצור אפליקציה שכוללת נתונים מהפלטפורמה של מפות Google במסמך?

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

איך אפשר למנוע את הכללת התוכן שלי בתוצאות החיפוש ב-Google?

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

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

האם אפשר ליצור תמונת מפה באמצעות ה-API הסטטי של מפות Google, לשמור ולהציג מהאתר שלי?

אין לאחסן ולהציג עותקים של תמונות שנוצרו באמצעות API סטטי של מפות Google מהאתר שלך. כל דפי האינטרנט שמחייבים תמונות סטטיות חייבות לקשר את המאפיין src של HTML img או את מאפיין ה-CSS background-image של תג HTML div ישירות לממשק ה-API הסטטי של מפות Google כך כל תמונות המפה מוצגות בתוכן ה-HTML של דף האינטרנט, מוצגות ישירות למשתמשי הקצה על ידי Google.

מגבלות שימוש וחיוב

איך מגדירים חיוב בפרויקט?

כדאי לעיין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.

איך לקוחות בתוכנית ללא תשלום של Google Cloud Platform משדרגים לחשבון בתשלום?

התוכנית ללא תשלום של Google Cloud Platform התוכנית מעניקה ללקוחות תקופת ניסיון ללא חיוב עם קרדיט בסך 300 $לשימוש בכל מכשיר Google Cloud שירות הפלטפורמה (GCP), כולל ממשקי ה-API של הפלטפורמה של מפות Google (GMP). אחרי תקופת הניסיון ללא חיוב מסתיים, צריך לשדרג לחשבון בתשלום כדי להמשיך להשתמש בשירותים האלה. כדי לשדרג לחשבון בתשלום, צריך להיכנס אל מסוף Cloud.

יש מגבלות שימוש בפלטפורמה של מפות Google?

אין מגבלות יומיות מקסימליות על מספר הבקשות שאפשר לשלוח מוצרי הפלטפורמה של מפות Google, ומגבלות השימוש היחידות קשורות המספר המקסימלי של שאילתות לשנייה (QPS) או של שאילתות לדקה (QPM).

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

ב'מסלולים:Compute Route Matrix', המגבלה היא ברכיבים לדקה (EPM), כאשר מספר הרכיבים בבקשה שווה ל: (מספר המקורות כפול מספר היעדים).

בטבלה הבאה מוצגת מגבלת השימוש לכל API.

API	מגבלת שימוש
אימות הכתובת	6,000 QPM
תצוגה אווירית: חיפוש וידאו	180 QP ו-100,000 QPD
תצוגה אווירית: עיבוד וידאו	100 QP ו-100 QPD
איכות האוויר	6,000 QPM
מסלול	3,000 QPM
מטריצת מרחק	60,000 EPM
מפות דינמיות	30,000 QPM
גובה	6,000 QPM
קידוד גיאוגרפי	3,000 QPM
מיקום גיאוגרפי	6,000 QPM
ממשק API של אריחי מפה: משבצות דו-ממדיות ומשבצות של Street View	6,000 QPM ו- 15,000 QPD
ממשק API של אריחי מפה: משבצות תלת-ממדיות פוטוריאליות	10,000 QPD
ממשק API של אריחי מפה: משבצות תלת-ממדיות פוטוריאליות: מעבד	12,000 QPM
מקומות	6,000 QPM
אבקנים	6,000 QPM
כבישים	30,000 QPM
נתיבים: מסלולים מחשוב	3,000 QPM
נתיבים: מטריצת מסלולי מחשוב	3,000 EPM
סולארי	600 QPM
מפות סטטיות	30,000 QPM
ממשק API של תמונות מראה הרחוב	30,000 QPM
אזור זמן	30,000 QPM

כדי לשלוט בהוצאות, אפשר לעקוב אחרי השימוש ב-API. ולהגדיר מגבלות יומיות על כל הבקשות לכל הבקשות API.

צריך לפרוס את המוצרים של הפלטפורמה של מפות Google בהתאם לתקן התנאים וההגבלות של הפלטפורמה של מפות Google.

איך מחושבת עלות השימוש?

לסקירה כללית של התמחור של מוצרי הפלטפורמה של מפות Google אפשר לקרוא גיליון מחירים.

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

איך נספרות טעינות של מפות בפלטפורמה של מפות Google?

בכל אחד מהמצבים הבאים נחייב אתכם על טעינת מפה אחת:

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

החיוב על תמונות פנורמה ב-Street View מתבצע בנפרד מטעינת המפות:

תמונות פנורמיות סטטיות של Street View יחויבו עבור כל בקשה ל-Street View. אפשר להציג את ה-API הסטטי כדי להטמיע תמונת פנורמה סטטית (לא אינטראקטיבית) של Street View.
תמונת פנורמית דינמית של Street View מחויבת עבור כל יצירה של אובייקט פנורמה ב-API JavaScript של מפות Google, ב-SDK של מפות ל-Android או ב-SDK של מפות עבור אפליקציה ל-iOS.

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

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

איך אפשר לעקוב אחר השימוש?

אפשר לעקוב אחרי השימוש בממשקי API נפרדים מסוף Google Cloud.

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

כדי לראות דוח תנועה ונתוני חיוב של פרויקט שלם: יש לבצע את השלבים הבאים:

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

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

מה קורה אם חורגים ממגבלות קצב הבקשות (QPS)?

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

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

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

חריגה ממגבלות השימוש

אם חורגים ממגבלות השימוש, מקבלים OVER_QUERY_LIMIT כתגובה.

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

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

האתר שלי מקבל תנועה רבה. אפשר להשתמש במוצרי הפלטפורמה של מפות Google?

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

אם האתר או האפליקציה שלי יהפכו לפופולריים לפתע, האם המפות שלי יופסקו עובד/ת?

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

איך יחושב השימוש ויחויב?

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

כמה עולה השימוש בפלטפורמה של מפות Google?

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

האם התמחור זמין במטבעות אחרים?

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

הגדרתי חיוב. איך אפשר לראות את החיוב?

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

משאבים נוספים:

הוראות לגבי להציג את היסטוריית התשלומים והעלויות.
הוראות לגבי חשבונית או קבלה על תשלום.
הוראות לגבי הגדרה וניהול של התראות חיוב.

כיצד ניתן להימנע מחיוב גבוה בגין עליות בלתי צפויות בשימוש?

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

הגבלת המגבלה היומית לחיוב:

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

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

לחלופין, אפשר לערוך כמה מכסות לממשקי API מרובים באמצעות IAM ו- Admin Quotas Dashboard.

טיפ: אפשר להשתמש במשוואה פשוטה כדי לקבוע את המכסה היומית שלכם, בהתאם בסכום שאתם רוצים להוציא. לדוגמה: (הוצאה חודשית / מחיר לכל)/30 = מכסה ליום (ל-API אחד). למשל, במפות Google JavaScript API, ניתן לבצע 28,000 קריאות בחודש במסגרת המסלול ללא חיוב. אם תגבילו את המכסה המכסה היומית של Maps JavaScript API היא 903 (כלומר 28,000 / 31), לא תחויב בתשלום. שימו לב ייתכן שההטמעה תתבצע באמצעות מספר ממשקי API שניתנים לחיוב, לכן עליכם לשנות את המשוואה לפי הצורך. חשוב לזכור, קרדיט בסך 200 דולר ארה"ב לפלטפורמה של מפות Google זמין מדי חודש, לכן חשוב להביא בחשבון את לחישוב.

הגדרה וניהול של התראות לגבי תקציב:

הגדרה התראות לגבי תקציב לשליחת התראות באימייל לאדמינים של חיובים החיובים בחשבון לחיוב מגיעים לסף שהגדרתם. Billing (חיוב) האדמינים יקבלו התראות באימייל כשהחיובים המשוערים בתאריך החשבון לחיוב חורג מ-50%, מ-90% ומ-100% מהסף.

קיבלתי הודעה שלפיה הפרויקט שלי מקושר אל 'הפלטפורמה של מפות Google' מעבר של חשבון", אבל אין לי גישה לחשבון הזה. מה עלי לעשות?

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

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

למה מגבלת המכסה שלי מוגדרת לבקשה אחת ליום? איך אפשר להגדיל את המגבלה?

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

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

קיבלתי הודעה על הפרת מדיניות בנושא חיוב. איך פותרים את הבעיה?

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

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

באילו מפתחות או פרטי כניסה צריך להשתמש עבור מפות Google שונות מוצרים?

בכל פעם שמשתמשים במוצרי הפלטפורמה של מפות Google, צריך לכלול API המפתח לאימות הבקשה שלכם. הפלטפורמה של מפות Google זמינה עבור אפליקציות ל-Android, ל-iOS או לאינטרנט, ובאמצעות שירותי אינטרנט בפרוטוקול HTTP.

מפתח API:

מפתח API הוא מזהה ייחודי שאתם ליצור באמצעות מסוף Cloud.
דוגמה לטעינת API באמצעות מפתח: &key=AIzaSyBjsINSH5x39Ks6c0_CoS1yr1Mb3cB3cVo

חתימה דיגיטלית:

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

הגבלות:

ההגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API לשיפור האבטחה. צפייה לקבלת פרטים נוספים, כדאי לעיין בשיטות מומלצות לשמירה על אבטחה ב-API.
אפשר להוסיף למפתח ה-API הגבלה על אפליקציות. לאחר ההגבלה, מפתח יפעל רק בפלטפורמות שתומכות בהגבלה מהסוג הזה. יש ארבעה סוגים של הגבלות על אפליקציות. ממשקי API שאוכפים את אותה הגבלה הסוג יכול להשתמש באותו מפתח מוגבל.
- כתובות IP (שרתים נפרדים) - לשימוש עם ממשקי API של שירותי אינטרנט.
- גורמים מפנים מסוג HTTP (אתרי אינטרנט) - לשימוש עם ב-web APIs.
- הגבלה על אפליקציות ל-Android (לפי שם החבילה וטביעת האצבע) – לשימוש עם SDK של מפות ל-Android.
- הגבלת אפליקציות ל-iOS (לפי מזהה החבילה של iOS) – לשימוש עם Maps SDK ל-iOS.
תוכלו גם להוסיף הגבלת API למפתח ה-API. מידע נוסף זמין במאמר הבא: קבלה, הוספה והגבלה של מפתח API

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

API או SDK	פרטי כניסה הגבלת אפליקציות
SDK של מפות ל-Android	מפתח API עם הגבלה ל-Android¹
Places SDK ל-Android	מפתח API עם הגבלה ל-Android¹
SDK של מפות ל-iOS	מפתח API עם הגבלה על iOS ¹
Places SDK ל-iOS	מפתח API עם הגבלה על iOS ¹
Maps JavaScript API	מפתח API עם הגבלה של הפניה ל-HTTP ¹
API של קטעי מפה	מפתח API עם הגבלה על כתובת IP¹
Maps Datasets API	אסימון OAuth
ממשק API של Aerial View	מפתח API עם הגבלה על כתובת IP¹
API סטטי של מפות Google	מפתח API עם הגבלה של הפניה ל-HTTP ¹ + חתימה דיגיטלית²
ממשק API סטטי של Street View	מפתח API עם הגבלה של הפניה ל-HTTP ¹ + חתימה דיגיטלית²
API להטמעה של מפות Google	מפתח API עם הגבלה של הפניה ל-HTTP ¹
API לאימות כתובות	מפתח API עם הגבלה על כתובת IP¹
Directions API	מפתח API עם הגבלה על כתובת IP¹
Distance Matrix API	מפתח API עם הגבלה על כתובת IP¹
API של גובה המסך	מפתח API עם הגבלה על כתובת IP¹
Geocoding API	מפתח API עם הגבלה על כתובת IP¹
Geolocation API	מפתח API עם הגבלה על כתובת IP¹
Places API	מפתח API עם הגבלה על כתובת IP¹
Roads API	מפתח API עם הגבלה על כתובת IP¹
Routes API	מפתח API עם הגבלה על כתובת IP¹
ממשק API של אזור זמן	מפתח API עם הגבלה על כתובת IP¹
ממשק API של איכות האוויר	מפתח API עם הגבלה על כתובת IP¹
ממשק API לאבקנים	מפתח API עם הגבלה על כתובת IP¹
Solar API	מפתח API עם הגבלה על כתובת IP¹

¹ הגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API לאבטחה מוגברת.

² בהתאם לשימוש, ייתכן שתידרש חתימה דיגיטלית API סטטי של מפות Google וגם ממשק API סטטי של Street View. ללא קשר לשימוש, מומלץ מאוד להשתמש גם מפתח API וגם חתימה דיגיטלית, כדי לאמת את הבקשות שלכם.

איך אפשר לשנות את סוג הגבלת המפתח מהפניה של HTTP להגבלה של כתובת IP?

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

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

מידע נוסף על מפתח API הגבלות שקשורות למוצרי הפלטפורמה של מפות Google.

כדי להעביר מפתח API עם הגבלת הפניה של HTTP להגבלה של כתובת IP: לבצע את הפעולות הבאות:

נכנסים לדף Credentials במסוף Cloud.
בוחרים את הפרויקט שמכיל את מפתח ה-API שרוצים לערוך.
בדף Credentials, בוחרים את השם מרשימת מפתחות ה-API של מפתח ה-API כדי לערוך את הפרטים של המפתח.
בקטע Key restrictions בדף, בוחרים באפשרות 'IP addresses'. (שרתי אינטרנט, משימות cron וכו')" ולהזין את כתובות ה-IP המתאימות של השרת, לאחר מכן לוחצים על 'שמירה'.

איך מקבלים מפתח API חדש?

כדאי לעיין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.

איך אפשר למצוא את השינויים שבוצעו בכל גרסה של מפות Google ממשקי API?

מידע על שינויים בגרסאות של רבים מממשקי ה-API של מפות Google זמין בקישורים הבאים:

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

https://issuetracker.google.com/bookmark-groups/76561

איך אפשר לטעון את ה-API לדף באופן אסינכרוני אחרי שהדף נטען?

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

איך אפשר להציג את המוצרים של הפלטפורמה של מפות Google בשפה שאינה אנגלית?

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

שפות נתמכות:

Google מעדכנת שפות נתמכות לעיתים קרובות. יכול להיות שהרשימה הזו חלקית והוא עשוי להשתנות.

קוד שפה	שפה	קוד שפה	שפה
af	אפריקאנס	ja	יפנית
sq	אלבנית	kn	קנאדה
לפנה"צ	אמהרית	kk	קזחית
ar	ערבית	ק"מ	חמרית
hy	ארמנית	ko	קוריאנית
az	אזרית	ky	קירגיזית
eu	בסקית	lo	לאו
be	בלארוסית	lv	לטבית
bn	בנגלית	lt	ליטאית
bs	בוסנית	mk	מקדונית
bg	בולגרית	ms	מלאית
my	בורמזית	ml	מליאלאם
ca	קטלאנית	mr	מראטהית
zh	סינית	mn	מונגולית
zh-CN	סינית (פשוטה)	ne	נפאלית
zh-HK	סינית (הונג קונג)	לא	נורווגית
zh-TW	סינית (מסורתית)	pl	פולנית
שעה	קרואטית	pt	פורטוגזית
cs	צ'כית	pt-BR	פורטוגזית (ברזיל)
da	דנית	pt-PT	פורטוגזית (פורטוגל)
nl	הולנדית	pa	פנג'אבי
en	אנגלית	ro	רומנית
en-AU	אנגלית (אוסטרליה)	ru	רוסית
en-GB	אנגלית (בריטניה)	sr	סרבית
et	אסטונית	si	סינהלית
fa	פרסית	sk	סלובקית
fi	פינית	sl	סלובנית
fil	פיליפינית	es	ספרדית
fr	צרפתית	es-419	ספרדית (אמריקה הלטינית)
fr-CA	צרפתית (קנדה)	sw	סווהילי
gl	גליציאנית	sv	שוודית
ka	גאורגית	ta	טמילית
de	גרמנית	te	טלוגו
el	יוונית	th	תאית
gu	גוג'ארטי	tr	טורקית
iw	עברית	uk	אוקראינית
hi	הינדי	ur	אורדו
hu	הונגרית	uz	אוזבקית
שווה	איסלנדית	vi	וייטנאמית
id [מזהה]	אינדונזית	zu	זולו
it	איטלקית

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

האם ניתן לגשת לפלטפורמה של מפות Google באמצעות SSL (HTTPS)?

API JavaScript של מפות Google, API סטטי של מפות Google Web Service APIs יכולים להיות ניגשו דרך חיבורים מאובטחים (HTTPS). אפשר לעיין במסמכים עבור ממשק ה-API שקשור למידע על אופן הגישה ל-API באמצעות SSL.

שימו לב שה-API הסטטי של מפות Google לא תומך בכתובות URL מותאמות אישית של סמלים שמשתמשות ב-HTTPS. ה יוצג סמל ברירת מחדל.

איך מדווחים על באג או מבקשים תכונה חדשה בפלטפורמה של מפות Google?

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

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

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

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

איך ממשקי API של הפלטפורמה של מפות Google משתמשים בקובצי cookie של אתרים?

ב-SDK של מפות Google ל-Android וב-SDK של מפות Google ל-iOS נעשה שימוש בקובצי cookie הכפופים ל מדיניות הפרטיות של Google, כמו חישוב יומי ומניעת ניצול לרעה של משתמשים פעילים במשך 7 ימים. קובצי ה-Cookie האלה לא משויכים לשום מחוברים לחשבון Google שלכם ולא רשומים עם שאר המידע שנאסף קריאות ל-API.

לא הצלחתי למצוא תשובה לשאלה שלי. למי צריך לפנות?

לצוות קשרי המפתחים של Google יש נוכחות ב-Stack Overflow — אתר שאלות ותשובות שנערך בשיתוף פעולה למתכנתים. אלה מקום מצוין לשאול בו שאלות טכניות על פיתוח ותחזוקה אפליקציות מפות Google. מידע נוסף על שאילת שאלות ב-Stack האפשרויות הנוספות זמינות בדף Support.

כדי לקבל את התוצאות הטובות ביותר כשמבקשים עזרה, חשוב לזכור את הדברים הבאים:

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

שגיאות ופתרון בעיות

מה המשמעות של השגיאה הזו?

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

המפות שלי נראות כהות יותר מהרגיל. מה קורה?

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

האם השתמשת במפתח API?

אין לי מושג איך אפשר לבדוק אם משתמשים במפתח API?

מפתח API מועבר בתור הפרמטר key בכתובת ה-URL שמשמש לטעינת API של מפות Google ל-JavaScript. יש כמה דרכים לבדוק אם אתם משתמשים במפתח API:

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

אזהרה לגבי JavaScript API של מפות Google: NoApiKeys
שגיאת JavaScript API של מפות Google: MissingKeyMapError

למפתחי אתרים:

אם יש לכם גישה לקוד המקור של האפליקציה, חפשו את <script> תג שמשמש לטעינת ממשק ה-API של JavaScript של מפות Google. בטעינה של Maps JavaScript API, צריך להחליף את YOUR_API_KEY בקוד שבהמשך, עם מפתח ה-API שלכם.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
לבדוק את התנועה ברשת שנוצרה על ידי האתר בדפדפן. ב-Chrome, אפשר לראות את הנתונים האלה באמצעות בכרטיסייה DevTools רשת. כאן יופיעו בקשות הרשת שנשלחו על ידי האתר שלכם. בקשות שבוצעו באמצעות ממשק ה-API של JavaScript של מפות Google יהיה מתחת לנתיב maps/api/js. כאן אפשר לבדוק אם הבקשות משתמשות בפרמטר key. אולי כדאי לסנן את התנועה ברשת לפי maps/api/js כשמעיינים בכרטיסייה רשת.

לא, אין לי מפתח API.

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

כן, יש לי מפתח API.

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

האם מצורף חשבון לחיוב לפרויקט שלכם?

אין לי מושג איך אפשר לבדוק אם חשבון לחיוב מצורף לפרויקט?

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

עוברים לקטע Credentials (פרטי כניסה), שאליו אפשר לגשת מהסרגל שבצד שמאל מתחת הפלטפורמה של מפות Google > פרטי כניסה.
בודקים שמפתח ה-API שבו אתם משתמשים כרגע באתר מופיע. אם זה לא המצב, עליכם לעבור לפרויקט אחר ולבדוק את פרטי הכניסה שם.
אם לא הצלחתם לאתר את הפרויקט עבור מפתח ה-API, יכול להיות שאיבדתם את הגישה לפרויקט הזה. תוכלו לבקש עזרה ממשתמשים אחרים בארגון. אם לא ניתן לאתר את הפרויקט המקורי, צריך לבצע את הפעולות הבאות:
1. יוצרים פרויקט חדש. כדי לעשות את זה, בוחרים באפשרות פרויקט חדש. ברשימת הפרויקטים, או על ידי בחירה באפשרות Create Project הדף 'מנהל המשאבים'.
2. יוצרים מפתח API חדש. אפשר לעשות את זה בדף Credentials. אחרי שנכנסים לדף, לוחצים על Create credentials ואז על API key.

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

לא, לא מצורף חשבון לחיוב לפרויקט שלי.

עוברים אל הדף Enable Billing במסוף Cloud. ומוסיפים חשבון לחיוב לפרויקט. מידע נוסף זמין במאמר הבא: תחילת העבודה עם הפלטפורמה של מפות Google.

כן, מצורף חשבון לחיוב לפרויקט שלי.

נהדר! עליך לוודא שאמצעי החיוב שסיפקת חוקי.

האם שיטת החיוב שסיפקתם לא תקפה יותר (לדוגמה, כרטיס אשראי שפג תוקפו)?

את/ה יכולים להוסיף, להסיר או לעדכן אמצעי תשלום במסוף Cloud.

האם יש חריגה מהמגבלה היומית שאתם מגדירים ב-API?

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

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

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

האם במפתח ה-API יש הגבלה על כתובות IP?

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

איך פותרים את קודי השגיאה: OVER_DAILY_LIMIT או OVER_QUERY_LIMIT?

אפשר להחזיר קודי שגיאה אלה מהסיבות הבאות:

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

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

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

איך פותרים את קודי השגיאה: kGMSPlacesRateLimitExceeded או 9005 PLACES_API_RATE_LIMIT_EXCEEDED?

אם רואים את kGMSPlacesRateLimitExceeded או את 9005 PLACES_API_RATE_LIMIT_EXCEEDED, יכול להיות שאתם משתמשים בגרסה שהוצאה משימוש של Places SDK ל-Android או Places SDK ל-iOS. מידע נוסף וערכות ה-SDK החדשות זמין בכתובת https://goo.gle/places-sdk-deprecation.

איך אפשר לפתור את השגיאה: "כתובת ה-IP הזו, האתר הזה או האפליקציה לנייד אינם מורשה להשתמש במפתח ה-API הזה."?

יש כמה תרחישים שעלולים לגרום לשגיאה הזו:

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

הצגה ועריכה של פרטי הכניסה של מפתח ה-API

כדי להציג את מפתחות ה-API ולנהל את ההגבלות:

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

איך פותרים את השגיאה: "לא ניתן להשתמש במפתחות API עם הגבלות של גורמים מפנים עם ה-API הזה"?

אתה משתמש באחד או יותר ממשקי API של שירותי אינטרנט באמצעות מפתח API שמוגבל לגורם מפנה של HTTP. מטעמי אבטחה, שירות אינטרנט ממשקי API צריכים להשתמש במפתחות API שמוגבלים לכתובות IP. החלפת סוג ההגבלה באמצעות המפתח מהפניה ל-HTTP הגבלה להגבלת כתובת IP, או ליצור מפתח API חדש אם המפתח כבר נמצא בשימוש עם Maps JavaScript API.

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

אני צריך להמיר כתובות לצמדי קו רוחב/קו אורך. האם אפשר לעשות את זה עם הפלטפורמה של מפות Google?

כן, התהליך הזה נקרא 'קידוד גיאוגרפי'. ממשק ה-API של JavaScript של מפות Google כולל מחלקה לביצוע שירות קידוד גיאוגרפי. הכיתה: google.maps.Geocoder.

לחלופין, Google מספקת גם Geocoding API, שמציע ממשק REST שיכול בפורמט JSON ו-XML.

באילו מדינות אפשר לבצע קידוד גיאוגרפי?

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

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

למה המקודדים הגיאוגרפיים של הפלטפורמה של מפות Google מספקים מיקומים שונים מאלו של Google מפות Google?

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

איך כדאי לעצב את השאילתות של הקואורדינטות כדי למקסם את מספר השאילתות בקשות?

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

צריך לציין כתובות בהתאם לפורמט שמשמש את הדואר הארצי שירות במדינה הרלוונטית.
אין לציין רכיבי כתובת נוספים כמו שמות עסק, יחידה מספרי קומה, מספרי קומות או מספרי דירות שלא נכללים הכתובת שהוגדרה על ידי שירות הדואר של המדינה הרלוונטית. פעולה זו עלולה להוביל לתשובות עם ZERO_RESULTS.
יש לעצב את ה-Plus Codes כפי שמוצג כאן (הסימן וה-URL מסומנים בתווי בריחה (escape) אל %2B ורווחים מסומנים בתווי בריחה (escape) ל-%20:
- קוד גלובלי הוא קוד אזור בן 4 תווים ו-6 תווים או יותר קוד מקומי (849VCWC8+R9 הוא 849VCWC8%2BR9).
- קוד מורכב הוא קוד מקומי באורך 6 תווים או יותר עם מיקום מפורש (CWC8+R9 Mountain View, CA, ארה"ב הוא CWC8%2BR9%20Mountain%20View%20CA%20USA).
השתמשו במספר הרחוב של הבניין עדיפות על שם הבניין, ככל האפשר.
השתמשו במספרי רחובות עם עדיפות גבוהה יותר כדי לציין צומתי רחובות שבהם ככל האפשר.
אין לספק 'רמזים'. כמו ציוני דרך בקרבת מקום.

כיצד אוכל להזין כתובת בארה"ב בכביש מהיר ממוספר לקידוד גיאוגרפי?

הקואורדינטות של הפלטפורמה של מפות Google חייבות שהכבישים המהירים הממוספרים בארה"ב יהיו מצוינים בכתובות באופן הבא:

כבישים מחוזיים: "Co Road NNN" כאשר NNN הוא מספר הכביש. לדוגמה: "Co Road 82"
כבישים מהירים של מדינה: "State NNN" כאשר State הוא השם המלא של המדינה (State) ו-NNN הוא מספר הכביש המהיר. לדוגמה: "California 82"
ארה"ב כבישים מהירים: "U.S. NNN" כאשר NNN הוא מספר הכביש המהיר. למשל "U.S. 101"
ארה"ב בין מדינות: "Interstate NNN" כאשר NNN הוא הכביש המהיר. מספר. לדוגמה: "Interstate 280"

מתי צריך להשתמש במחלקה של קואורדינטות של API ומתי להשתמש ב-HTTP שירות קידוד גיאוגרפי?

צפייה במסמך: Geocoding אסטרטגיות, שמפרטות את היתרונות והחסרונות של קידוד גיאוגרפי שונה אסטרטגיות למשימות.

איך אפשר לספק מסלול נסיעה באמצעות הפלטפורמה של מפות Google?

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

ממשק בקשה/תגובה של HTTP (בשימוש באפליקציות לנייד ובאפליקציות אחרות) תואם ל-SDK של מפות Google ל-Android ולשירותי אינטרנט אחרים של מפות Google.
JavaScript API, לאפליקציות בצד הלקוח, מאפשר לכם לספק מסלול נסיעה דרך google.maps.DirectionsService. DirectionsRenderer הכיתה יכולה ליצור עבורכם באופן אוטומטי את שכבות-העל ואת חלונית המסלול. דוגמאות נוספות מופיעות במסמכי התיעוד.
ממשקי הלקוח של Java, Python, go ו-Node.js, באפליקציות בצד השרת. מספקות את אותה פונקציונליות. מידע נוסף על ספריות לקוח זמין במאמר ספריות לקוח של Directions API.

באילו מדינות זמינים מסלולי נסיעה?

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

באילו מדינות זמינים מסלולי תחבורה ציבורית?

Directions API וגם Target Matrix API לספק תמיכה לכל השותפים של Google Transit, חוץ מאלה שביפן.

אילו תכונות KML ו-GeoRSS נתמכות ב-JavaScript API של מפות Google?

KmlLayer ב-JavaScript API של מפות Google, מפתחים יכולים ליצור שכבות-על של KML/KMZ קובצי GeoRSS בחלק העליון של המפה. ניתן למצוא מסמכים ודוגמאות כאן.

מהן המגבלות על הגודל והמורכבות של KML שאפשר להציג משתמשים במחלקה KmlLayer של ממשק ה-API של JavaScript של מפות Google?

מגבלות הגודל והמורכבות על הצגת קובץ KML באמצעות כיתה אחת (KmlLayer) תועדה כאן.

איך אפשר לעבד קובצי KML שמתארחים ברשת אינטראנט אתרים במפה?

מחלקה KmlLayer שיוצרת שכבות-על של KML ב-Maps JavaScript API נעשה שימוש בשירות שמתארח ב-Google כדי לאחזר ו לנתח קובצי KML לעיבוד. לכן לא ניתן להציג קובצי KML שלא מתארחים בכתובת URL שזמינה באופן ציבורי נגישים או שדורשים אימות כדי לגשת אליהם.

אם צריך לפתח אפליקציות שמשתמשות בקובצי KML שמתארחים ברשת אינטראנט אתרים שאנו ממליצים להם לעבד את ה-KML בצד הלקוח באמצעות ספריות JavaScript של צד שלישי. כשמתבצע ניתוח של קובץ ה-KML אחרים, עשויים להיות נמוכים יותר בהשוואה לשימוש כיתה אחת (KmlLayer).

מהו המספר המרבי של סמנים או נתיב קודקודים הנתמכים על ידי Maps Static API?

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

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

למה אי אפשר לגשת למוצרים של הפלטפורמה של מפות Google במדינות מסוימות?

אין להשתמש בממשקי API של מפות Google באזורים אסורים. מומלץ לעיין גם בתנאים ובהגבלות.

איך אפשר לדווח על בעיה במפה הבסיסית של Google?

לשלוח משוב דרך מפות Google לגבי פרטי מפה שגויים או חסרים, למשל:

כתובות שגויות או סמנים במיקום שגוי
שמות שגויים של כבישים
מידע שגוי על כבישים חד-סטריים ודו-סטריים
כביש ששורטט בצורה שגויה
כבישים סגורים
כבישים שלא קיימים

כדי לתקן מקום או דף עסק, צריך לשלוח הצעת עריכה.

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

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

איך מתנהל מעקב אחר הביצועים של השירותים שבהם נעשה שימוש ב-Maps JavaScript API?

חלק מהתכונות בצד הלקוח משמשות לדיווח על הצלחה או כישלון לצורך חישוב ה-SLO (יעד רמת השירות). המידע הזה נשלח אל Google במספר maps.googleapis.com/maps_api_js_slo/log בשיחות שמתעדות פרטי SLO. המידע הזה כולל את סטטוס ההצלחה, זמן האחזור והגרסה/הערוץ של API JavaScript של מפות Google שנמצאים בשימוש. יכול להיות שהשיחות יקובצו באצווה כדי לשפר את הביצועים. לתשומת ליבך, ייתכן שיהיה עליך לאשר את maps.googleapis.com ב Content Security Policy כדי לוודא השיחות האלה לא חסומות ברמת הדפדפן. לדוגמה: Content-Security-Policy: default-src 'self' maps.googleapis.com; עם כותרות HTTP, או <meta http-equiv="Content-Security-Policy" content="default-src 'self' maps.googleapis.com;"> עם מטא תגים של HTML.

Maps JavaScript API

כמה זמן יפעל ממשק ה-API של JavaScript של מפות Google לאחר טעינתו?: עליך לרענן את הדף שטוען את ממשק ה-API של JavaScript של מפות Google לפחות פעם ב-5 ימים.

SDK של מפות Google ל-iOS

איך פותרים את השגיאה: kGMSPlacesRateLimitExceeded?

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

מופיעות קריסות במהלך ניפוי באגים במכשיר iOS 8.x. מה עליי לעשות?

אם נתקלים בבעיות במהלך ניפוי באגים במכשירים שמותקנת בהם מערכת ההפעלה iOS 8.x, יש לפעול לפי כדי להשבית את לכידת הפריימים של GPU בסכימת ה-XCode שאתם מפעילים:

ב-XCode, בוחרים באפשרות מוצר, סכמה, ניהול סכימות.
בוחרים סכמה ובוחרים באפשרות עריכה....
מגדירים את האפשרות GPU Frame capture כ-Disabled. לתשומת ליבכם: ייתכן שהאפשרות הזו לא תהיה זמינה בכל המכשירים.

האפשרות של צילום פריימים ב-GPU של Xcode בדף הכללי של מכשיר iOS

מה ההשפעה של מסכים מעוגלים ורחבים יותר על ה-SDK של מפות Google ל-iOS?

החל ב-iPhone X, מכשירי iPhone מתאפיינים בצורת מסך עם פינות מעוגלות, עם חריץ בחלק העליון שמשמש מארז חיישן, וכן אינדיקטור בחלק התחתון של המסך לגישה אל מסך הבית. החל מ-iOS 11.0 SDK, Apple הוסיפה את Safe Area API שמאפשר למפתחים רכיבים באזור שלא ייחתך על ידי המסך החדש .

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

בגרסה 2.5 של מפות Google ל-iOS SDK, בעיות הפריסה האלה נפתרו באופן אוטומטי. כשמשתמשים באפליקציה במכשיר iPhone X ואילך, המרווח הפנימי ב-GMSMapView וב-GMSPanoramaView מוגדל. כדי שהרכיבים החזותיים לא ייחתכו.

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

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

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

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

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

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

SDK של מפות Google ל-Android

איך פותרים את השגיאה: 9005 PLACES_API_RATE_LIMIT_EXCEEDED?: אם השגיאה הזו מופיעה, יכול להיות שאתם משתמשים בגרסה שהוצאה משימוש של Places SDK ל-Android. גרסת Google Play Services של Places SDK ל-Android הושבת ולא זמין יותר. עליך לעדכן את האפליקציה לגרסה העדכנית ביותר בהקדם האפשרי. לצפייה פרטים נוספים זמינים במדריך להעברת נתונים (מיגרציה).

האפליקציה שלי מציגה רק משבצות אפורות ריקות במקום מפה. איך פותרים את הבעיה?

אחת הסיבות הנפוצות לכך שמופיעים משבצות אפורות ריקות במקום מפה היא בעיות אימות. אפשר לבצע את השלבים הבאים כדי לפתור את הבעיות האלה באמצעות adb Logcat.

חשוב לוודא שהתקנת את adb. אם לא, אפשר לפעול לפי המדריך כאן.
מתקינים את האפליקציה שבה מופיעה הבעיה במכשיר או באמולטור Android. אם משתמשים באמולטור Android, צריך לוודא שחנות Play מוגדרת בהגדרות האמולטור.
בטרמינל של Android Studio מריצים את adb logcat -e "Google Maps Android API". הפעולה הזו תדפיס רק שורות שבהן הודעת היומן תואמת ל-"Google Maps Android API" (אפשר גם לצרף את היומן לקובץ טקסט כפלט של היומן: > Logcat.txt)
משחזרים את הבעיה במכשיר ומחפשים שגיאות נפוצות כמו:

במניפסט יש הפניה למפתח API שגוי או לא מכוון.
אפשרות החיוב לא מופעלת בפרויקט.
ערכת ה-SDK לא מופעלת בממשקי API של הפרויקט.
טביעת האצבע השגויה ב-SHA1 נוספה להגבלות של מפתחות ה-API.
יחסי התלות של שירות Google Play לא כלולים בקובץ build.gradle.

חתימה על כתובות URL

האם אפשר לחתום על כתובות URL באמצעות JavaScript?

מומלץ מאוד לא לחתום על כתובות URL באמצעות JavaScript, כי זה עלול לחשוף את סוד החתימה על כתובות URL למשתמשי קצה. לכן חתימות רק על ידי רכיבים בצד השרת.

למה מתקבלת תגובה אסורה מסוג HTTP 403 בקשות לשירות האינטרנט של Maps API?

תגובת HTTP 403 מציינת בעיית הרשאה, כנראה כי לא ניתן לאמת את החתימה עבור הבקשה הזו. הסיבה לכך יכולה להיות:

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