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

תחילת העבודה

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

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

שימוש ב-Google Maps Platform

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

שירותים של Google Maps Platform

Maps JavaScript API

‫SDK של מפות ל-iOS

‫Google Maps SDK ל-Android

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

תחילת העבודה

מהי Google Maps Platform?

Google Maps Platform היא אוסף של ממשקי 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, כמו מכשירי אייפון של אפל.

באפליקציות שמיועדות למכשירים שלא מתאימים לשימוש בממשק API של JavaScript במפות Google,‏ Maps Static API מספק תמונות של מפות בפורמטים GIF,‏ JPG ו-PNG, כולל סמנים וקווי פוליגון. שימו לב: כדי להשתמש ב-Maps Static API באפליקציות שלא מבוססות על דפדפן, צריך לקשר את תמונת המפה למפות 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?

הדפסה מ-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 או Gmail במרכז העזרה של חשבון Google.

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

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

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

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

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

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

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

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

כן, עכשיו אפשר להשתמש במוצרים של 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 או את מאפיין ה-CSS‏ background-image של תג 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: Lookup Video 180 שאילתות לדקה ו-100,000 שאילתות ליום
‫Aerial View: Render Video 100 שאילתות לדקה ו-100 שאילתות ליום
איכות האוויר 6,000 QPM
‫Maps JavaScript API: מפות תלת-ממדיות 30,000 QPM
‫Maps JavaScript API: מפות דינמיות ‫30,000 QPM
גובה 6,000 QPM
המרת כתובות לקואורדינטות (geocoding) 3,000 QPM
מיקום גיאוגרפי 6,000 QPM
Maps Grounding Lite 300 QPM
‫Map Tiles API: משבצות מפה דו-ממדיות ‫6,000 QPM ו-15,000 QPD
‫Map Tiles API: משבצות ב-Street View ‫6,000 QPM ו-15,000 QPD
‫Map Tiles API: קטעי מפה ריאליסטיים בתלת-ממד 12,000 שאילתות לדקה ו-10,000 בקשות בסיס ביום.
ניווט: הגדרת בקשות ליעד 30,000 QPM
מקומות 6,000 QPM
Places Aggregate 1,200 QPM
אבקנים 6,000 QPM
כבישים 30,000 QPM
Routes: Compute Routes 3,000 QPM
‫Routes: Compute Route Matrix 3,000 EPM
שמש 600 QPM
מפות סטטיות 30,000 QPM
Street View Image API 30,000 QPM
אזור זמן 30,000 QPM
מזג אוויר 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. בחלק העליון של הדף, לוחצים על מדדים או על מכסות.

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

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

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

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

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

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

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

חריגה ממכסות השימוש

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אחרי שיוצרים חשבון לחיוב ומקשרים אותו, תקרת נפח האחסון היומית מוסרת. אתם יכולים להגדיר מגבלה במסוף 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 או SDK של Google Maps Platform.

API/SDK הגבלת פרטי כניסה ואפליקציות
‫SDK של מפות ל-Android מפתח API עם הגבלה ל-Android1
Places SDK ל-Android מפתח API עם הגבלה ל-Android1
Navigation SDK ל-Android מפתח API עם הגבלה ל-Android1
‫SDK של מפות ל-iOS מפתח API עם הגבלה ל-iOS1
Places SDK ל-iOS מפתח API עם הגבלה ל-iOS1
‫Navigation SDK ל-iOS מפתח API עם הגבלה ל-iOS1
Maps JavaScript API מפתח API עם הגבלת מפנה HTTP1
Map Tiles API מפתח API עם הגבלת כתובת IP1
Maps Datasets API טוקן OAuth
Aerial View API מפתח API עם הגבלת כתובת IP1
Maps Static API מפתח API עם הגבלה של מפנה HTTP‏1 + חתימה דיגיטלית2
Street View Static API מפתח API עם הגבלת מפנה HTTP1 + חתימה דיגיטלית2
Maps Embed API מפתח API עם הגבלת מפנה HTTP1
Address Validation API מפתח API עם הגבלת כתובת IP1
Elevation API מפתח API עם הגבלת כתובת IP1
Geocoding API מפתח API עם הגבלת כתובת IP1
Geolocation API מפתח API עם הגבלת כתובת IP1
Places API מפתח API עם הגבלת כתובת IP1
Places Aggregate API מפתח API עם הגבלת כתובת IP1
Roads API מפתח API עם הגבלת כתובת IP1
Routes API מפתח API עם הגבלת כתובת IP1
Time Zone API מפתח API עם הגבלת כתובת IP1
Air Quality API מפתח API עם הגבלת כתובת IP1
Pollen API מפתח API עם הגבלת כתובת IP1
Solar API מפתח API עם הגבלת כתובת IP1
Weather API מפתח API עם הגבלת כתובת IP1
1 הגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API כדי לשפר את האבטחה.
‫2 בהתאם לשימוש, יכול להיות שתידרשו לחתום בחתימה דיגיטלית על Maps Static API ועל Street View Static API. לא משנה איך משתמשים ב-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 jobs, etc.)' (כתובות IP (שרתי אינטרנט, משימות cron וכו')) ומזינים את כתובות ה-IP המתאימות של השרת, ואז לוחצים על Save (שמירה).
איך מקבלים מפתח API חדש?
ראו תחילת העבודה עם Google Maps Platform.
איפה אפשר למצוא את השינויים שנוספו בכל גרסה של ממשקי Google Maps API?

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

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

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

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

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

איך אפשר להציג מוצרים של 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 סינית (הונג קונג) לא נורווגית
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)?

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

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

מידע נוסף מופיע בשאלות הנפוצות על העברת אישור הבסיס של רשות האישורים של 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 זמין בדף התמיכה.

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

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

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

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

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

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

בנסיבות מסוימות, יכול להיות שתוצג מפה מושחרת או תמונה 'שלילית' של 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.
איך פותרים את השגיאה: "לכתובת ה-IP, לאתר או לאפליקציה לנייד האלה אין הרשאה להשתמש במפתח ה-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?

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

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

באילו מדינות זמין גיאו-קידוד?

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

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

למה מפענחי מיקום גיאוגרפי של Google Maps Platform מספקים מיקומים שונים מאלה של מפות Google?

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

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

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

  • צריך לציין את הכתובות בהתאם לפורמט שבו משתמש שירות הדואר הלאומי של המדינה הרלוונטית.
  • אל תציינו רכיבי כתובת נוספים כמו שמות עסקים, מספרי יחידות, מספרי קומה או מספרי דירות שלא נכללים בכתובת כפי שהוגדרה על ידי שירות הדואר של המדינה הרלוונטית. אם תעשו את זה, יכול להיות שתקבלו תשובות עם ZERO_RESULTS.
  • צריך להשתמש בפורמט של Plus Codes כמו שמוצג כאן (סימני הפלוס מוצגים בפורמט URL-escaped כ-%2B והרווחים מוצגים בפורמט URL-escaped כ-%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"
  • כבישים מהירים בארה"ב: ‫"US NNN" כאשר NNN הוא מספר הכביש המהיר. למשל "US 101"
  • כבישים בין-מדינתיים בארה"ב: ‫"Interstate NNN" כאשר NNN הוא מספר הכביש הבין-מדינתי. למשל: "Interstate 280"
מתי כדאי להשתמש במחלקה של API לקידוד גאוגרפי ומתי כדאי להשתמש בשירות ה-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 ושותפים ביפן.

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

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

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

המגבלות על הגודל והמורכבות של הצגת KML באמצעות המחלקה KmlLayer מתועדות בסקירה הכללית של KmlLayer.

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

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

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

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

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

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

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

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

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

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

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

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

איך מתבצע מעקב אחר הביצועים של השירותים שבהם נעשה שימוש עם 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 ימים.

‫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. בוחרים סכימה ולוחצים על עריכה....
  3. מגדירים את האפשרות GPU Frame Capture לDisabled. שימו לב שהאפשרות הזו לא מופיעה בכל המכשירים.
האפשרות Xcode GPU Frame Capture בדף Generic iOS device (מכשיר iOS כללי)
מה ההשפעה של מסכים מעוגלים ורחבים על ה-SDK של מפות Google ל-iOS?

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

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

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

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

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

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

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

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

לעומת זאת, ל-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 מותקן. אם לא, אפשר לפעול לפי המדריך ל-adb ב-Android.
  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.
האם נדרשת האצת חומרה ל-SDK של מפות ל-Android?
כן, צריך להגדיר את hardwareAccelerated לערך true בקובץ AndroidManifest.xml של האפליקציה כדי למנוע בעיות בטעינת המפה.
מידע נוסף מופיע בדף בנושא האצת חומרה במסמכי התיעוד למפתחי Android.

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

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

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

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

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

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