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

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

תחילת העבודה

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

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

מפות Google:

מסלולים:

מקומות:

סביבה:

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

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

איזה ממשק API דרוש לי?

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

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

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

באילו מדינות פועלת פלטפורמת מפות Google?

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

מידע נוסף זמין במאמרים הבאים:

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

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

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

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

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

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

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

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

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

ממשק ה-API של JavaScript במפות Google ו-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

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

האם אפשר להדפיס מפות מ-Maps JavaScript API?

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

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

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

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

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

מתי התמיכה הטכנית זמינה?

צוות התמיכה זמין 24/5 (ימי חול מיום שני בשעה 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 של מפות Google ו-Places ל-iOS במחשבי Mac מבוססי-Arm?

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

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

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

התנאים וההגבלות של Google Maps Platform זמינים בכתובת:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

האם אפשר ליצור תמונה של מפה באמצעות Maps Static API, לשמור אותה ולהציג אותה באתר?

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

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

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

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

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

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

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

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

עבור Distance Matrix, המגבלה מוגדרת באירועים לדקה (EPM) ומחושבת כסכום של שאילתות בצד הלקוח ובצד השרת.

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

ב-Navigation SDKs, כל יעד בבקשה נספר כשאילתה נפרדת.

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

API	מגבלת שימוש
אימות כתובת	6,000 QPM
תצוגה אווירית: חיפוש סרטון	180 שאילתות לשעה ו-100,000 שאילתות ליום
תצוגה אווירית: עיבוד וידאו	100 שאילתות לשנייה ו-100 שאילתות לדקה
איכות האוויר	6,000 QPM
מסלול	3,000 שאילתות לשעה
Distance Matrix	60,000 עלות בפועל לאלף חשיפות
מפות דינמיות	30,000 QPM
גובה	6,000 QPM
המרת כתובות לקואורדינטות (geocoding)	3,000 שאילתות לשעה
מיקום גיאוגרפי	6,000 QPM
Map Tiles API: משבצות דו-ממדיות ומשבצות ב-Street View	6,000 QPM ו-15,000 QPD
Map Tiles API: קטעי מפה ריאליסטיים בתלת-מימד	10,000 שאילתות לשעה
Map Tiles API: קטעי מפה ריאליסטיים בתלת-מימד: עיבוד גרפיקה	12,000 QPM
ניווט: הגדרת בקשות לקבלת מסלול	30,000 QPM
מקומות	6,000 QPM
אבקנים	6,000 QPM
כבישים	30,000 QPM
מסלולים: Compute Routes	3,000 שאילתות לשעה
מסלולים: חישוב מטריצת המסלולים	3,000 עלות בפועל לאלף חשיפות
סולאריים	600 QPM
מפות סטטיות	30,000 שאילתות לשעה
ממשק API של תמונות מראה הרחוב	30,000 QPM
אזור זמן	30,000 שאילתות לשעה

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הגבלת הסכום המקסימלי לחיוב יומי:

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

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

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

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

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

מגדירים התראות לגבי תקציב כדי לשלוח התראות באימייל לאדמינים לענייני חיוב כשהחיובים בחשבון לחיוב מגיעים לסף שהגדרתם. האדמינים לענייני חיוב יקבלו התראות באימייל כשהחיובים המשוערים בחשבון לחיוב יחרגו מ-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 מספקת לכם. חתימות דיגיטליות משמשות עם Maps Static API ו-Street View Static API.

הגבלות:

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

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

API/SDK	הגבלת פרטי כניסה ואפליקציות
SDK של מפות ל-Android	מפתח API עם הגבלה ל-Android¹
Places SDK ל-Android	מפתח API עם הגבלה ל-Android¹
Navigation SDK ל-Android	מפתח API עם הגבלה ל-Android¹
SDK של מפות ל-iOS	מפתח API עם הגבלה ל-iOS¹
Places SDK ל-iOS	מפתח API עם הגבלה ל-iOS¹
Navigation SDK ל-iOS	מפתח API עם הגבלה ל-iOS¹
Maps JavaScript API	מפתח API עם הגבלה על גורם מפנה מסוג HTTP¹
Map Tiles API	מפתח API עם הגבלת כתובת IP¹
Maps Datasets API	טוקן OAuth
Aerial View API	מפתח API עם הגבלת כתובת IP¹
Maps Static API	מפתח API עם הגבלת HTTP referer¹ + חתימה דיגיטלית²
Street View Static API	מפתח API עם הגבלת HTTP referer¹ + חתימה דיגיטלית²
Maps Embed API	מפתח API עם הגבלה על גורם מפנה מסוג HTTP¹
Address Validation API	מפתח API עם הגבלת כתובת IP¹
Directions API	מפתח API עם הגבלת כתובת IP¹
Distance Matrix API	מפתח API עם הגבלת כתובת IP¹
Elevation API	מפתח API עם הגבלת כתובת IP¹
Geocoding API	מפתח API עם הגבלת כתובת IP¹
Geolocation API	מפתח API עם הגבלת כתובת IP¹
Places API	מפתח API עם הגבלת כתובת IP¹
Roads API	מפתח API עם הגבלת כתובת IP¹
Routes API	מפתח API עם הגבלת כתובת IP¹
Time Zone API	מפתח API עם הגבלת כתובת IP¹
Air Quality API	מפתח API עם הגבלת כתובת IP¹
Pollen API	מפתח API עם הגבלת כתובת IP¹
Solar API	מפתח API עם הגבלת כתובת IP¹

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

² בהתאם לשימוש, יכול להיות שתצטרכו חתימה דיגיטלית ל-Maps Static API ול-Street View Static API. ללא קשר לשימוש, מומלץ מאוד להשתמש גם במפתח API וגם בחתימה דיגיטלית כדי לאמת את הבקשות.

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

חשוב: אם אתם משתמשים באחד מממשקי ה-API של שירותי האינטרנט עם מפתח API שיש לו הגבלות על גורמים מפנים, הבקשות שלכם ייכשל עם הודעת השגיאה: "API keys cannot have referer restrictions when used with this API". צריך לעבור לשימוש במפתח API עם הגבלות על כתובות IP.

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

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

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

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

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

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

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

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

אפשר גם לבדוק באיזו גרסה של הפלטפורמה של מפות 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 ולממשקי API של שירותי אינטרנט בחיבור מאובטח (HTTPS). במסמכי העזרה של ממשק ה-API הרלוונטי מוסבר איך לגשת ל-API דרך SSL.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אזהרה בנושא Google Maps JavaScript API: NoApiKeys
שגיאה ב-Google Maps JavaScript API: MissingKeyMapError

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

אם יש לכם גישה לקוד המקור של האפליקציה, חפשו את התג <script> שמשמש לטעינת Maps JavaScript API. כשאתם מעמיסים את 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. כאן יוצגו בקשות הרשת שנשלחו מהאתר שלכם. בקשות שנשלחות באמצעות Google Maps JavaScript API יהיו בנתיב maps/api/js. כאן אפשר לוודא אם הבקשות כוללות את הפרמטר key. כדאי לסנן את תעבורת הנתונים ברשת לפי maps/api/js כשמציגים את הכרטיסייה Network.

לא, אני לא משתמש במפתח API.

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

כן, אני משתמש במפתח API.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אפשר לבדוק את המגבלות היומיות בדף APIs & Services Dashboard במסוף 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 שסופק לא תקין.
לפרויקט לא מצורף חשבון לחיוב.
חרגתם ממכסת השימוש שהגדרתם לעצמכם.
אמצעי התשלום שצוין כבר לא תקף (לדוגמה, פג התוקף של כרטיס אשראי).
חרגתם ממגבלות המכסות של ממשק 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.

איך פותרים את השגיאה: "This IP, site or mobile application is not authorized to use this API key"?

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

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

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

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

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

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

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

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

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

כן, התהליך הזה נקרא 'גיאוקוד'. ‏Maps JavaScript API כולל קלאס לביצוע שירות המרת כתובות לקואורדינטות (geocoding). הכיתה היא: google.maps.Geocoder.

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

באילו מדינות זמינה הגיאוקודציה?

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

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

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

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

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

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

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

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

כדי שהמקודם הגיאוגרפי של Google Maps Platform יזהה כבישים מהירים בארה"ב, צריך לציין אותם בכתובות באופן הבא:

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

מתי כדאי להשתמש בכיתה של שירות קידוד גיאוגרפי של API ומתי כדאי להשתמש בשירות הקידוד הגיאוגרפית של HTTP?

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

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

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

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

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

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

באילו מדינות אפשר לקבל מסלולי תחבורה ציבורית?

Directions API ו-Distance Matrix API תומכים בכל שותפי התחבורה הציבורית של Google, מלבד שותפים ביפן.

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

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

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

המגבלות על הגודל והמורכבות של תצוגת ה-KML באמצעות הכיתה KmlLayer מתועדות כאן.

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

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

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

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

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

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

למה אין לי גישה למוצרים של Google Maps Platform במדינות מסוימות?

אסור להשתמש בממשקי 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: 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 ימים.

Google Maps SDK ל-iOS

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

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

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

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

ב-XCode, בוחרים באפשרות Product (מוצר), Scheme (סכימה), Manage Schemes (ניהול סכימות).
בוחרים סכימה ולוחצים על Edit…‎ (עריכה…).
מגדירים את האפשרות GPU Frame Capture לערך Disabled. הערה: יכול להיות שהאפשרות הזו לא תופיע בכל המכשירים.

האפשרות Xcode GPU Frame Capture בדף Generic iOS device

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

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

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

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

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

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

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

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

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

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

Google Maps SDK ל-Android

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

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

סיבה נפוצה להצגת משבצות אפורות ריקות במקום מפה היא בעיות באימות. כדי לפתור את הבעיות האלה, אפשר לפעול לפי השלבים הבאים באמצעות 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 Services לא נכללים בקובץ build.gradle.

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

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

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

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

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

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