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

תחילת העבודה

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

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

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

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

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

Maps JavaScript API

‫Google Maps SDK ל-iOS

‫Google Maps SDK ל-Android

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

תחילת העבודה

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

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

מפות:

מסלולים:

מקומות:

סביבה:

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

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

איזה API צריך?

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

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

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

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

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

כדאי לעיין גם במאמרים הבאים:

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

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

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

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

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

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

באפליקציות שמיועדות למכשירים שלא מתאימים לשימוש ב-Maps JavaScript API,‏ 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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API מגבלת שימוש
Address Validation 6,000 QPM
‫Aerial View: חיפוש סרטון ‫180 QPM ו-100,000 QPD
Aerial View: Render Video 100 QPM ו-100 QPD
איכות האוויר 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
‫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
מסלולים: חישוב מסלולים 3,000 QPM
‫Routes: Compute Route Matrix 3,000 EPM
שמש 600 QPM
מפות סטטיות 30,000 QPM
ממשק API של תמונות מראה הרחוב 30,000 QPM
אזור זמן 30,000 QPM
מזג אוויר 6,000 QPM

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

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

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

סקירה כללית של התמחור של מוצרים בפלטפורמה של מפות Google זמינה ברשימת המחירים.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API/SDK הגבלת פרטי כניסה ואפליקציות
Maps 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 עם הגבלה של גורם מפנה מסוג HTTP1 + חתימה דיגיטלית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
איך אפשר לראות את השינויים שנוספו בכל גרסה של ממשקי Google Maps API?

בקישורים הבאים אפשר למצוא מידע על שינויי גרסאות של רבים מממשקי 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 אסטונית 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 אורדו
שווה איסלנדית uz אוזבקית
id [מזהה] אינדונזית vi וייטנאמית
it איטלקית zu זולו

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


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

כדי להשתמש במוצרי הפלטפורמה של מפות Google, צריך חשבון לחיוב, וכל הבקשות צריכות לכלול מפתח 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. נכנסים אל דף פרטי הכניסה במסוף Cloud.
  2. בוחרים את הפרויקט שמכיל את מפתח ה-API שרוצים לבדוק.
  3. כדי לראות את פרטי אמצעי האימות, כולל ההגבלות שהוגדרו למפתח, לוחצים על שם המפתח ברשימת מפתחות ה-API.
  4. מוצגים פרטי הכניסה המלאים של מפתח ה-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 שמוחזר כדי לקבוע אם נמצאה התאמה טובה מספיק למטרות האפליקציה. הזמינות של נתוני הגיאו-קידוד תלויה בחוזים שלנו עם ספקי נתונים, ולכן היא עשויה להשתנות.

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

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

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

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

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

  • כבישים מקומיים:"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?

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

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

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

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

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

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

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

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

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

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

למה אין לי גישה למוצרים של 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 אחרי הטעינה שלו?

צריך לרענן את הדף שבו נטען ממשק 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 שמופעלת:

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

החל מ-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. הגרסה של Google Play Services של Places SDK ל-Android הושבתה, והיא לא זמינה יותר. כדאי לעדכן את האפליקציה לגרסה האחרונה בהקדם האפשרי. פרטים נוספים זמינים במדריך להעברת נתונים.
באפליקציה שלי מוצגים רק משבצות אפורות ריקות במקום מפה. איך אפשר לפתור את הבעיה?

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

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

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

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

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

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

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