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

תחילת העבודה

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

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

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

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

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

Maps JavaScript API

SDK של מפות Google ל-iOS

SDK של מפות Google ל-Android

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

תחילת העבודה

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

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

מפות Google:

מסלולים:

מקומות:

סביבה:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מחשב
  • הגרסה הנוכחית של Microsoft Edge (Windows), לא כולל מצב IE.
  • שתי הגרסאות היציבות והעדכניות ביותר של Firefox (Windows , macOS ו-Linux).
  • שתי הגרסאות הגדולות והיציבות האחרונות של Chrome (Windows,‏ macOS,‏ Linux).
  • שתי הגרסאות היציבות העיקריות האחרונות של Safari (macOS).
Android
  • הגרסה הנוכחית של Chrome ב-Android מגרסה 4.1 ואילך.
  • Chrome WebView ב-Android מגרסה 4.4 ואילך.
iOS
  • דפדפן Safari לנייד בגרסה הנוכחית ובגרסאות הקודמות העיקריות של iOS.
  • UIWebView ו-WKWebView בגרסאות העיקריות הנוכחיות והקודמות של iOS.
  • הגרסה הנוכחית של Chrome ל-iOS.
האם ניתן להדפיס מפות מתוך Maps JavaScript API?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בערכות ה-SDK לניווט, כל יעד בבקשה נספר כשאילתה נפרדת.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

מפתח API:

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

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

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

הגבלות:

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

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

API/SDK הגבלת פרטי כניסה ואפליקציות
SDK של מפות ל-Android מפתח API עם הגבלה ל-Android1
Places SDK ל-Android מפתח API עם הגבלה ל-Android1
SDK לניווט ל-Android מפתח API עם הגבלה ל-Android1
SDK של מפות ל-iOS מפתח API עם הגבלה ל-iOS1
Places SDK ל-iOS מפתח API עם הגבלה על iOS 1
Navigation SDK ל-iOS מפתח API עם הגבלה ל-iOS1
Maps JavaScript API מפתח API עם הגבלה על גורם מפנה מסוג HTTP1
Map Tiles API מפתח API עם הגבלה על כתובת IP1
Maps Datasets API אסימון OAuth
Aerial View API מפתח API עם הגבלת כתובת IP1
API סטטי של מפות Google מפתח API עם הגבלה של הפניה ל-HTTP 1 + חתימה דיגיטלית2
Street View Static API מפתח API עם הגבלת HTTP referer1 + חתימה דיגיטלית2
API להטמעה של מפות Google מפתח API עם הגבלה של הפניה ל-HTTP 1
Address Validation API מפתח API עם הגבלה על כתובת IP1
Directions API מפתח API עם הגבלת כתובת IP1
Distance Matrix API מפתח API עם הגבלה על כתובת IP1
API של גובה המסך מפתח API עם הגבלת כתובת IP1
Geocoding API מפתח API עם הגבלת כתובת IP1
Geolocation API מפתח API עם הגבלת כתובת IP1
Places API מפתח API עם הגבלת כתובת IP1
Roads API מפתח API עם הגבלה על כתובת IP1
Routes API מפתח API עם הגבלה על כתובת IP1
ממשק API של אזור זמן מפתח API עם הגבלה על כתובת IP1
ממשק API של איכות האוויר מפתח API עם הגבלה על כתובת IP1
ממשק API לאבקנים מפתח API עם הגבלת כתובת IP1
Solar API מפתח API עם הגבלה על כתובת IP1
1 הגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API לאבטחה מוגברת.
2 בהתאם לשימוש, יכול להיות שיידרש חתימה דיגיטלית ל-Maps Static API ול-Street View Static API. ללא קשר לשימוש, מומלץ מאוד להשתמש גם מפתח API וגם חתימה דיגיטלית, כדי לאמת את הבקשות שלכם.
איך משנים את סוג ההגבלה של המפתח מגורם מפנה מסוג HTTP להגבלה על כתובת IP?

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

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

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

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

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

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

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

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

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

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

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

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

שפות נתמכות:

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

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

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

האם אפשר לגשת לפלטפורמה של מפות Google דרך SSL‏ (HTTPS)?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בנסיבות מסוימות, מפה כהה או 'שלילית' תמונת 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?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps JavaScript API

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

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

SDK של מפות Google ל-iOS

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

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

  1. ב-XCode, בוחרים באפשרות מוצר, סכמה, ניהול סכימות.
  2. בוחרים סכמה ובוחרים באפשרות עריכה....
  3. מגדירים את האפשרות GPU Frame capture כ-Disabled. הערה: יכול להיות שהאפשרות הזו לא תופיע בכל המכשירים.
האפשרות של צילום פריימים באמצעות GPU של Xcode בדף הכללי של מכשיר iOS
מה ההשפעה של מסכים מעוגלים ורחבים יותר על ה-SDK של מפות Google ל-iOS?

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

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

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

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

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

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

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

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

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

Google Maps SDK ל-Android

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

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

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

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

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

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

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

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

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