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

תחילת העבודה

הבנת התנאים וההגבלות

מגבלות שימוש וחיוב (מכסות)

שימוש ב-Google Maps Platform

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

שירותי Google Maps Platform

Maps JavaScript API

Google Maps SDK ל-iOS

Google Maps SDK ל-Android

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

תחילת העבודה

מה זה Google Maps Platform?

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

מפות Google:

מסלולים:

מקומות:

סביבה:

איך מתחילים להשתמש ב-Google Maps Platform?

איך מתחילים לעבוד עם Google Maps Platform

איזה API צריך?

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

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

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

באילו מדינות אפשר להשתמש ב-Google Maps Platform?

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

מידע נוסף:

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

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

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

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

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

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

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

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

ממשקי ה-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?

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

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

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

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

במאמר תמיכה ומקורות מידע של Google Maps Platform מפורטות אפשרויות התמיכה הזמינות.

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

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

איך אפשר לקבל שוב גישה לפרויקט ספציפי?

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

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

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

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

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

הבנת התנאים וההגבלות

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

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

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

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

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

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

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

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

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

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

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

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

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

‫Maps JavaScript API נתמך רק כשהוא פועל באחד מ הדפדפנים הנתמכים.

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

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

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

אם האפליקציה שלכם יוצרת מסמך, בפורמט אלקטרוני או מודפס, אסור לכלול במסמך נתונים מ-Google Maps Platform, כולל תמונות. לפרטים נוספים, קראו את הסעיף "No Scraping" בתנאים ובהגבלות של Google Maps Platform.

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

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

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

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

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

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

איך מגדירים חיוב לפרויקט?
ראו תחילת העבודה עם Google Maps Platform.
מהי תקופת הניסיון בחינם ב-Google Cloud ואיך משתמשים בתקופת הניסיון בחינם משדרגים לחשבון בתשלום?

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

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

האם יש מגבלות שימוש (מכסות) ב-Google Maps Platform?

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

בטבלה הבאה מוצגת מגבלת השימוש לכל API. אפשר לראות ולשנות את מגבלות המכסות במסוף Cloud.

API מכסת שימוש
Address Validation 6,000 QPM
‫Aerial View: חיפוש סרטון ‫180‎ QPM ו-100,000‎ QPD
‫Aerial View: רינדור סרטון ‫100 שאילתות לדקה ו-100 שאילתות ליום
איכות האוויר 6,000 QPM
‫Maps JavaScript API: מפות תלת-ממדיות ‫30,000 שאילתות לדקה
‫Maps JavaScript API: מפות דינמיות ‫30,000 שאילתות לדקה
גובה 6,000 שאילתות לדקה
המרת כתובות לקואורדינטות (geocoding) 3,000 שאילתות לדקה
מיקום גיאוגרפי 6,000 שאילתות לדקה
‫Maps Grounding Lite: חיפוש מקומות, בדיקת מזג האוויר, חישוב מסלולים ‫300 שאילתות לדקה לכל כלי
‫Maps Grounding Lite: פתרון שמות, פתרון כתובות URL של מפות Google ‫600 שאילתות לדקה לכל שיטה
‫Map Tiles API: משבצות מפה דו-ממדיות ‫6,000 שאילתות לדקה ו-15,000 שאילתות ליום
‫Map Tiles API: משבצות ב-Street View 6,000 QPM ו-15,000 QPD
‫Map Tiles API: קטעי מפה ריאליסטיים בתלת-ממד ‫12,000 שאילתות לדקה ו-10,000 בקשות ביום.
ניווט: בקשות להגדרת יעד ‫30,000 שאילתות לדקה
מקומות 6,000 QPM
Places Aggregate ‫1,200 שאילתות לדקה
אבקנים 6,000 שאילתות לדקה
כבישים ‫30,000 שאילתות לדקה
‫Routes: חישוב מסלולים ‫3,000 שאילתות לדקה
‫Routes: Compute Route Matrix 3,000 אירועים לדקה
שמש 600‎ QPM
מפות סטטיות ‫30,000 שאילתות לדקה
Street View Image API ‫30,000 שאילתות לדקה
אזור זמן ‫30,000 שאילתות לדקה
מזג אוויר 6,000 QPM

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

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

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

לסקירה כללית של מחירי המוצרים ב-Google Maps Platform, ראו את מחירון.

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

איך נספרות טעינות המפה ב-Google Maps Platform?

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

  • דף אינטרנט או אפליקציה שמציגים מפה באמצעות 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.

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

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

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

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

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

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

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

הערה: לממשקי ה-API הבאים של שירותי אינטרנט יש שירות מקביל בצד הלקוח שזמין ב-Maps JavaScript API: ‏Elevation, ‏Geocoding.

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

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

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

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

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

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

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

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

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

כמה עולה להשתמש ב-Google Maps Platform?

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

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

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

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

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

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

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

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

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

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

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

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

קיבלתי הודעה שהפרויקט שלי מקושר ל-Google Maps Platform Transition Account, אבל אין לי גישה לחשבון הזה. מה עלי לעשות?

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

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

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

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

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

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

שימוש ב-Google Maps Platform

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

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

מפתח API:

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

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

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

הגבלות:

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

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

API או SDK הגבלת פרטי כניסה ואפליקציות
Maps SDK for Android מפתח API עם הגבלה ל-Android‏1
Places SDK ל-Android מפתח API עם הגבלה ל-Android‏1
Navigation SDK ל-Android מפתח API עם הגבלה ל-Android‏1
SDK של מפות ל-iOS ‫מפתח API עם הגבלה ל-iOS‏1
Places SDK ל-iOS ‫מפתח API עם הגבלה ל-iOS‏1
‫ Navigation SDK ל-iOS ‫מפתח API עם הגבלה ל-iOS‏1
Maps JavaScript API מפתח API עם הגבלת מפנה HTTP‏1
Map Tiles API מפתח API עם הגבלה של כתובת IP‏1
Maps Datasets API טוקן OAuth
Aerial View API מפתח API עם הגבלה של כתובת IP‏1
Maps Static API מפתח API עם הגבלת מפנה HTTP‏1 + חתימה דיגיטלית2
Street View Static API מפתח API עם הגבלת מפנה HTTP‏1 + חתימה דיגיטלית2
Maps Embed API מפתח API עם הגבלת מפנה HTTP‏1
Address Validation API מפתח API עם הגבלה של כתובת IP‏1
Elevation API מפתח API עם הגבלה של כתובת IP‏1
Geocoding API מפתח API עם הגבלה של כתובת IP‏1
Geolocation API מפתח API עם הגבלה של כתובת IP‏1
Places API מפתח API עם הגבלה של כתובת IP‏1
Places Aggregate API מפתח API עם הגבלה של כתובת IP‏1
Roads API מפתח API עם הגבלה של כתובת IP‏1
Routes API מפתח API עם הגבלה של כתובת IP‏1
Time Zone API מפתח API עם הגבלה של כתובת IP‏1
Air Quality API מפתח API עם הגבלה של כתובת IP‏1
Pollen API מפתח API עם הגבלה של כתובת IP‏1
Solar API מפתח API עם הגבלה של כתובת IP‏1
Weather API מפתח API עם הגבלה של כתובת IP‏1
‫1 הגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API כדי לשפר את האבטחה.
‫2 בהתאם לשימוש, יכול להיות שתידרש חתימה דיגיטלית ל-Maps Static API ול-Street View Static API. בלי קשר לשימוש, מומלץ מאוד להשתמש גם במפתח API וגם בחתימה דיגיטלית כדי לאמת את הבקשות.
איך מחליפים את סוג ההגבלה על המפתח מהגבלה על גורם מפנה מסוג HTTP להגבלה על כתובת IP?

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

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

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

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

  1. נכנסים לדף Credentials במסוף Cloud.
  2. בוחרים את הפרויקט שמכיל את מפתח ה-API שרוצים לערוך.
  3. בדף Credentials, בוחרים את השם של מפתח ה-API שרוצים לערוך את הפרטים שלו מרשימת מפתחות ה-API.
  4. בקטע Key restriction בדף, בוחרים באפשרות "IP addresses (web servers, משימות cron, etc.)", מזינים את כתובות ה-IP המתאימות של השרת ולוחצים על Save.
איך מקבלים מפתח API חדש?
ראו איך מתחילים לעבוד עם Google Maps Platform.
איך אפשר למצוא את השינויים שנוספו בכל גרסה של ממשקי ה-API של מפות Google?

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

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

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

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

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

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

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

שפות נתמכות:

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

קוד שפה שפה קוד שפה שפה
af אפריקאנס ja יפנית
sq אלבנית kn קנאדה
am אמהרית 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 סינית (הונג קונג) no נורווגית
zh-TW סינית (מסורתית) pl פולנית
שעה קרואטית pt פורטוגזית
cs צ'כית pt-BR פורטוגזית (ברזיל)
da דנית pt-PT פורטוגזית (פורטוגל)
nl הולנדית pa פנג'אבי
en אנגלית ro רומנית
en-AU אנגלית (אוסטרליה) ru רוסית
en-GB אנגלית (בריטניה) sr סרבית (באותיות קיריליות)
et אסטונית sr-Latn סרבית (אותיות לטיניות)
fa פרסית si סינהלית
fi פינית sk סלובקית
fil פיליפינית sl סלובנית
fr צרפתית es ספרדית
fr-CA צרפתית (קנדה) es-419 ספרדית (אמריקה הלטינית)
gl גליציאנית sw סווהילי
ka גאורגית sv שוודית
de גרמנית ta טמילית
el יוונית te טלוגו
gu גוג'ראטי th תאית
iw עברית tr טורקית
hi הינדי uk אוקראינית
hu הונגרית ur אורדו
is איסלנדית uz אוזבקית
id אינדונזית vi וייטנאמית
it איטלקית zu זולו

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

האם אפשר לגשת ל-Google Maps Platform דרך HTTPS‏ (TLS)?

אפשר ומומלץ לגשת לכל ממשקי ה-API של Google Maps Platform דרך HTTPS. כדי להבטיח שהאפליקציות שלכם ימשיכו לפעול בעתיד, מומלץ מאוד להשתמש ב-TLS 1.3 ל-HTTPS. למרות שעדיין יש תמיכה בגרסאות TLS ישנות יותר, אנחנו ממליצים לא להסתמך על גרסאות TLS 1.0 ו-1.1 הישנות שהוצאו משימוש.

פרוטוקול ה-SSL שהוצא משימוש כבר לא נתמך.

מידע נוסף זמין בשאלות הנפוצות בנושא העברת אישור הבסיס של רשות האישורים (CA) של Google Maps Platform ובשאלות הנפוצות בנושא Google Trust Services.

איך מדווחים על באג או מבקשים תכונה חדשה ב-Google Maps Platform?

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

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

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

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

איך ממשקי ה-API של Google Maps Platform משתמשים בקובצי Cookie של אתרים?

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

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

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

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

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

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

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

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

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

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


איך פותרים את קודי השגיאה: OVER_DAILY_LIMIT או OVER_QUERY_LIMIT?
קודי השגיאה האלה יכולים להופיע מהסיבות הבאות:
  • בבקשה חסר מפתח API.
  • מפתח ה-API שסיפקת לא תקין.
  • לפרויקט לא מקושר חשבון לחיוב.
  • חרגתם ממכסת השימוש שהגדרתם לעצמכם.
  • אמצעי התשלום שסופק כבר לא תקף (לדוגמה, פג התוקף של כרטיס האשראי).
  • חרגתם ממגבלות המכסה של API מסוים.

כדי להשתמש במוצרים של Google Maps Platform, צריך חשבון לחיוב וכל הבקשות חייבות לכלול מפתח 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"?

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

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

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

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

  1. נכנסים לדף Credentials במסוף Cloud.
  2. בוחרים את הפרויקט שמכיל את מפתח ה-API שרוצים לבדוק.
  3. כדי לראות את פרטי פרטי הכניסה, כולל ההגבלות שהוגדרו למפתח, לוחצים על שם המפתח ברשימה של מפתחות ה-API.
  4. פרטי הכניסה המלאים של מפתח ה-API שנבחר מוצגים, כולל כל ההגבלות שהוגדרו למפתח. מכאן אפשר לשנות, למחוק או לעדכן את ההגבלות לפי הצורך.
איך פותרים את השגיאה: "אי אפשר להשתמש ב-API הזה עם מפתחות API שיש להם הגבלות על הגורם המפנה"?

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

שירותי Google Maps Platform

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

כן, התהליך הזה נקרא "המרת כתובות לקואורדינטות (geocoding)". ‫Maps JavaScript API כולל מחלקה לביצוע שירות המרת כתובות לקואורדינטות (geocoding). ה-class הוא: google.maps.Geocoder.

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

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

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

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

למה הכלים להמרת כתובות לקואורדינטות של Google Maps Platform מספקים מיקומים שונים מאלה של מפות Google?

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

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

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

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

כדי להשתמש בכלי להמרת כתובות לקואורדינטות (geocoder) של Google Maps Platform, צריך לציין בכתובות את הכבישים המהירים הממוספרים בארה"ב באופן הבא:

  • כבישים מחוזיים: "Co Road NNN" כאשר NNN הוא מספר הכביש. לדוגמה: "Co Road 82"
  • כבישים מהירים במדינה: "State NNN" כאשר State הוא השם המלא של המדינה ו-NNN הוא מספר הכביש המהיר. לדוגמה: "California 82"
  • כבישים מהירים בארה"ב: "US NNN" כאשר NNN הוא מספר הכביש המהיר. למשל "US 101"
  • כבישים בין-מדינתיים בארה"ב: "Interstate NNN" כאשר NNN הוא מספר הכביש הבין-מדינתי. לדוגמה: "Interstate 280"
מתי כדאי להשתמש במחלקה של כלי להמרת כתובות לקואורדינטות (geocoder) ב-API, ומתי כדאי להשתמש בשירות המרת הכתובות לקואורדינטות (geocoding) ב-HTTP?

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

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

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

ממשק בקשת/תגובת HTTP (בשימוש באפליקציות לנייד ובאפליקציות אחרות) תואם ל-SDK של מפות ל-Android ולשירותי אינטרנט אחרים של מפות Google.

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

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

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

‫Routes API תומך בכל שותפי Google Transit, חוץ מ-Indian Railway Catering and Tourism Corporation ושותפים ביפן.

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

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

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

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

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

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

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

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

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

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

חלק מהתכונות בצד הלקוח מוגדרות לדווח על הצלחה או כישלון כדי לחשב את ה-SLO (יעד למדידת רמת השירות). המידע הזה נשלח אל Google בכתובת maps.googleapis.com/maps_api_js_slo/log בקריאות שמתעדות מידע על SLO. המידע הזה כולל את סטטוס ההצלחה, זמן האחזור והגרסה או הערוץ של Maps JavaScript API שנמצאים בשימוש. יכול להיות שהקריאות יקובצו כדי לשפר את הביצועים. יכול להיות שתצטרכו לאשר את 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

כמה זמן Maps JavaScript API יפעל אחרי שהוא נטען?

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

Google Maps SDK ל-iOS

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

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

  1. ב-XCode, בוחרים באפשרויות Product (מוצר), Scheme (סכימה), Manage Schemes (ניהול סכימות).
  2. בוחרים סכימה ולוחצים על Edit...‎.
  3. מגדירים את האפשרות GPU Frame Capture לערך Disabled. שימו לב: יכול להיות שהאפשרות הזו לא תופיע בכל המכשירים.
האפשרות Xcode GPU Frame Capture בדף Generic iOS device
איך מסכים מעוגלים ורחבים יותר משפיעים על Maps SDK ל-iOS?

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

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

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

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

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

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

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

אם 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.

  1. מוודאים ש-adb מותקן. אם לא, אפשר לפעול לפי המדריך ל-Android adb.
  2. מתקינים את האפליקציה שבה הבעיה מופיעה במכשיר או באמולטור Android. אם אתם משתמשים באמולטור Android, ודאו שחנות Play כלולה בהגדרות האמולטור.
  3. בטרמינל של Android Studio, מריצים את הפקודה adb logcat -e "Google Maps Android API". הפקודה הזו תדפיס רק שורות שבהן הודעת היומן תואמת ל-"Google Maps Android API" (אפשר גם להוסיף את הפקודה ‎> logcat.txt‎ כדי להוציא את היומן לקובץ טקסט)
  4. משחזרים את הבעיה במכשיר ובודקים אם יש שגיאות נפוצות כמו:
    • במניפסט יש הפניה למפתח API שגוי או לא מכוון.
    • החיוב לא מופעל בפרויקט.
    • ערכת ה-SDK לא מופעלת בממשקי ה-API של הפרויקט.
    • טביעת האצבע השגויה של SHA-1 נוספה להגבלות על מפתח ה-API.
    • יחסי התלות של Google Play Services לא כלולים בקובץ build.gradle.
האם נדרש שיפור מהירות באמצעות חומרה ב-Google Maps SDK ל-Android?
כן, צריך להגדיר את hardwareAccelerated לערך true בקובץ AndroidManifest.xml של האפליקציה כדי למנוע בעיות בטעינת המפה.
מידע נוסף זמין בדף שיפור מהירות באמצעות חומרה במאמרי העזרה למפתחים של Android.

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

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

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

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

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

  1. צוינה חתימה, אבל היא לא נכונה לבקשה הזו.
  2. בבקשה צוין מפתח API של מינוי פרימיום לפלטפורמה של מפות Google, אבל לא צוינה חתימה, והשירות שאליו נשלחה הקריאה מחייב שבקשות שנשלחות באמצעות מפתח API יכללו חתימה חוקית.
  3. צוינה חתימה, אבל לא צוין מפתח ה-API המשויך של מינוי הפרימיום של Google Maps Platform.