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

תחילת העבודה

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

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

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

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

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

Maps JavaScript API

SDK של מפות Google ל-iOS

SDK של מפות Google ל-Android

חתימת כתובת URL

תחילת העבודה

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

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

מפות:

מסלולים:

מקומות:

סביבה:

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

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

איזה API צריך?

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

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

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

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

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

ראה גם:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

התנאים וההגבלות של הפלטפורמה של מפות Google זמינים בכתובת:

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הגבלת המגבלה היומית לחיוב:

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

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

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

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

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

הגבלות:

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

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

API/SDK הגבלות על פרטי כניסה ואפליקציות
SDK של מפות ל-Android מפתח API עם הגבלה ב-Android 1
Places SDK ל-Android מפתח API עם הגבלה ב-Android 1
SDK של מפות ל-iOS מפתח API עם הגבלה ב-iOS 1
Places SDK ל-iOS מפתח API עם הגבלה ב-iOS 1
Maps JavaScript API מפתח API עם הגבלה על גורם מפנה של HTTP1
API של משבצות המפה מפתח API עם הגבלה על כתובת IP 1
Aerial View API מפתח API עם הגבלה על כתובת IP 1
Static API של מפות Google מפתח API עם הגבלה על גורם מפנה של HTTP1 + חתימה דיגיטלית2
Street View Static API מפתח API עם הגבלה על גורם מפנה של HTTP1 + חתימה דיגיטלית2
Maps Embed API מפתח API עם הגבלה על גורם מפנה של HTTP1
URL Validation API מפתח API עם הגבלה על כתובת IP 1
Directions API מפתח API עם הגבלה על כתובת IP 1
מרחק Matrix API מפתח API עם הגבלה על כתובת IP 1
Elevation API מפתח API עם הגבלה על כתובת IP 1
API לקידוד גיאוגרפי מפתח API עם הגבלה על כתובת IP 1
API של מיקום גיאוגרפי מפתח API עם הגבלה על כתובת IP 1
Place API מפתח API עם הגבלה על כתובת IP 1
Roads API מפתח API עם הגבלה על כתובת IP 1
Routes API מפתח API עם הגבלה על כתובת IP 1
Time Zone API מפתח API עם הגבלה על כתובת IP 1
Air Quality API מפתח API עם הגבלה על כתובת IP 1
Pollen API מפתח API עם הגבלה על כתובת IP 1
Solar API מפתח API עם הגבלה על כתובת IP 1
1 ההגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API לצורך אבטחה מוגברת.
2 בהתאם לשימוש, ייתכן שתידרש חתימה דיגיטלית עבור Maps Static API ו-Street View Static API. ללא קשר לשימוש, מומלץ מאוד להשתמש גם במפתח API וגם בחתימה דיגיטלית כדי לאמת את הבקשות.
איך אפשר לשנות את סוג הגבלת המפתחות מגורם מפנה של HTTP להגבלה על כתובת IP?

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

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

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

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

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

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

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

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

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

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

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

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

שפות נתמכות:

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

קוד שפה Language קוד שפה Language
af אפריקאנס ja יפנית
sq אלבנית kn קנאדה
AM אמהרית kk קזחית
ar ערבית ק"מ חמרית
hy ארמנית ko קוריאנית
az אזרית ky קירגיזית
eu בסקית lo לאו
be בלארוסית lv לטבית
bn בנגלית lt ליטאית
bs בוסנית mk מקדונית
bg בולגרית ms מלאית
my בורמזית ml מליאלאם
ca קטלאנית mr מראטהית
zh סינית mn מונגולית
zh-CN סינית (פשוטה) ne נפאלית
zh-HK סינית (הונג קונג) no נורווגית
zh-TW סינית (מסורתית) pl פולנית
שעה קרואטית pt פורטוגזית
cs צ'כית pt-BR פורטוגזית (ברזיל)
da דנית pt-PT פורטוגזית (פורטוגל)
nl הולנדית pa פנג'אבי
en אנגלית ro רומנית
en-AU אנגלית (אוסטרליה) ru רוסית
en-GB אנגלית (בריטניה) sr סרבית
et אסטונית 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)?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


איך פותרים את קודי השגיאה: OVER_DAILY_LIMIT או OVER_QUERY_LIMIT?
אפשר להחזיר את קודי השגיאה האלה מכל אחת מהסיבות הבאות:
  • חסר בבקשה מפתח API.
  • מפתח ה-API שהזנת לא תקין.
  • לפרויקט לא מצורף חשבון לחיוב.
  • חרגת ממכסת השימוש בהגדרה עצמית.
  • אמצעי התשלום שסיפקת כבר לא בתוקף (לדוגמה, פג התוקף של כרטיס האשראי).
  • חרגת ממגבלות ה-QPS של 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. נכנסים לדף Credentials ב-Cloud Console.
  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?

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

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

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

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

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

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

קראו את המסמך: אסטרטגיות קידוד גיאוגרפי, המפרט את היתרונות והחסרונות של אסטרטגיות שונות של קידוד גיאוגרפי.

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

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

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

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

באילו מדינות זמין מסלול לתחבורה ציבורית?

Directions API ו-מרחק Matrix API תומכים בכל השותפים של Google Transit, למעט אלה ביפן.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Maps JavaScript API

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

עליכם לרענן את הדף שטוען את JavaScript API של מפות 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 כמושבתת. שימו לב: יכול להיות שהאפשרות הזו לא תוצג בכל המכשירים.
אפשרות Xcode GPU Frame Capture בדף הכללי של מכשיר iOS
מה ההשפעה של מסכים מעוגלים ורחבים יותר ב-SDK של מפות Google ל-iOS?

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

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

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

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

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

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

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

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

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

SDK של מפות Google ל-Android

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

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

  1. חשוב לוודא שהתקנת את 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 של הפרויקט.
    • טביעת האצבע השגויה מסוג SHA1 מתווספת להגבלות של מפתחות ה-API.
    • יחסי תלות של Google Play Services לא כלולים בקובץ build.gradle.

חתימת כתובת URL

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

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

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

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

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