דף זה תורגם על ידי Cloud Translation API.

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

תחילת העבודה

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

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

מפות Google:

מסלולים:

מקומות:

סביבה:

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

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

איזה API צריך?

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

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

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

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

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

ראו גם:

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

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

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

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

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

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

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

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

Mobile Safari בגרסה הנוכחית ובגרסה הראשית הקודמת של iOS.
UIWebView ו-WKWebView בגרסה הנוכחית ובגרסה הראשית הקודמת של iOS.
הגרסה הנוכחית של Chrome ל-iOS.

האם ניתן להדפיס מפות מתוך Maps JavaScript API?

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

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

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

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

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

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

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

איך אפשר לשחזר את הגישה לחשבון Google?

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

הערה: כדי לשחזר את הגישה לחשבון G Suite, צריך לבקש מהאדמין בארגון לבטל את מחיקת החשבון.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

איך מגדירים חיוב בפרויקט?

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

איך לקוחות בתוכנית ללא תשלום של Google Cloud Platform משדרגים לחשבון בתשלום?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

אם האתר או האפליקציה שלי יהפכו לפתאומיים פופולריים, האם המפות שלי יפסיקו לפעול?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

טיפ: אפשר להשתמש במשוואה פשוטה כדי לקבוע את המכסה היומית, בהתאם לסכום שאתם רוצים להוציא. לדוגמה: (הוצאה חודשית / מחיר לכל) חלקי 30 = מכסה יומית של בקשות (ל-API אחד). לדוגמה, ב-JavaScript API של מפות Google, ניתן לבצע 28,000 קריאות בחודש בתוכנית ללא חיוב. אם תגבילו את המכסה היומית של Maps JavaScript API ל-903 (כלומר, 28,000 / 31), לא תחויבו. חשוב לשים לב שההטמעה עשויה להשתמש בכמה ממשקי API שניתנים לחיוב, לכן צריך לשנות את המשוואה לפי הצורך. חשוב לזכור: זיכוי בסך 200 דולר ארה"ב לפלטפורמה של מפות Google זמין בכל חודש, לכן חשוב להביא את העובדה הזו בחישוב.

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

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

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

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

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

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

אם לא יצרת וצירפת חשבון לחיוב לפרויקט, ממשקי ה-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 שאוכפים את אותו סוג הגבלה.
- כתובות IP (שרתים נפרדים) – לשימוש בממשקי ה-API של שירותי אינטרנט.
- גורמים מפנים מסוג HTTP (אתרי אינטרנט) – לשימוש באמצעות ממשקי ה-API באינטרנט.
- הגבלה על אפליקציות ל-Android (לפי שם החבילה וטביעת האצבע) – לשימוש עם ה-SDK של מפות Google ל-Android.
- הגבלת אפליקציות ל-iOS (לפי מזהה החבילה של iOS) – לשימוש עם ה-SDK של מפות Google ל-iOS.
תוכלו גם להוסיף הגבלת API למפתח ה-API. מידע נוסף זמין במאמר קבלה, הוספה והגבלה של מפתח API.

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

API/SDK	הגבלות על פרטי כניסה ואפליקציות
SDK של מפות ל-Android	מפתח API עם הגבלה ל-Android¹
Places SDK ל-Android	מפתח API עם הגבלה ל-Android¹
SDK של מפות ל-iOS	מפתח API עם הגבלה על iOS ¹
Places SDK ל-iOS	מפתח API עם הגבלה על iOS ¹
ממשק JavaScript API של מפות Google	מפתח API עם הגבלה של הפניה ל-HTTP ¹
API של אריחי מפה	מפתח API עם הגבלה על כתובת IP¹
ממשק API של Aerial View	מפתח API עם הגבלה על כתובת IP¹
API סטטי של מפות Google	מפתח API עם הגבלת הפניה אוטומטית של HTTP ¹ + חתימה דיגיטלית²
ממשק API סטטי של Street View	מפתח API עם הגבלת הפניה אוטומטית של HTTP ¹ + חתימה דיגיטלית²
API של מפות Google להטמעה	מפתח API עם הגבלה של הפניה ל-HTTP ¹
API לאימות כתובת	מפתח API עם הגבלה על כתובת IP¹
Directions API	מפתח API עם הגבלה על כתובת IP¹
Distance Matrix API	מפתח API עם הגבלה על כתובת IP¹
Layerion API	מפתח API עם הגבלה על כתובת IP¹
Geocoding API	מפתח API עם הגבלה על כתובת IP¹
Geolocation API	מפתח API עם הגבלה על כתובת IP¹
Places API	מפתח API עם הגבלה על כתובת IP¹
Roads API	מפתח API עם הגבלה על כתובת IP¹
Routes API	מפתח API עם הגבלה על כתובת IP¹
ממשק API של אזור זמן	מפתח API עם הגבלה על כתובת IP¹
Air Quality API	מפתח API עם הגבלה על כתובת IP¹
ממשק API לאבקנים	מפתח API עם הגבלה על כתובת IP¹
Solar API	מפתח API עם הגבלה על כתובת IP¹

¹ הגבלות על מפתחות API הן אופציונליות, אבל מומלץ מאוד להגביל את כל מפתחות ה-API לאבטחה מוגברת.

² בהתאם לשימוש, ייתכן שתידרש חתימה דיגיטלית עבור ה-API הסטטי של מפות Google ו-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, מבצעים את הפעולות הבאות:

נכנסים לדף Credentials במסוף Cloud.
בוחרים את הפרויקט שמכיל את מפתח ה-API שרוצים לערוך.
בדף Credentials, בוחרים את השם של מפתח ה-API מהרשימה של מפתחות ה-API כדי לערוך את הפרטים של המפתח.
בקטע Key restrictions, בוחרים באפשרות IP addresses (web servers, cron jobs וכו')", מזינים את כתובות ה-IP המתאימות של השרת ולוחצים על Save (שמירה).

איך מקבלים מפתח 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	קאנדה
בבוקר	אמהרית	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)?

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

שימו לב שה-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 תקף. התהליך הבא יעזור לפתור את הבעיה:

האם השתמשת במפתח API?

אין לי מושג איך אפשר לבדוק אם משתמשים במפתח API?

מפתח API מועבר בתור הפרמטר key בכתובת ה-URL שמשמש לטעינת API של JavaScript של מפות Google. יש כמה דרכים לבדוק אם אתם משתמשים במפתח API:

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

אזהרה לגבי JavaScript API של מפות Google : NoApiKeys
שגיאת JavaScript API של מפות Google : MissingKeyMapError

למפתחי אתרים:

אם יש לכם גישה לקוד המקור של האפליקציה, עליכם לחפש את התג <script> שמשמש לטעינת ממשק ה-API של JavaScript של מפות Google. כשטוענים את ממשק ה-API של JavaScript של מפות Google, צריך להחליף את הערך YOUR_API_KEY בקוד שבהמשך במפתח ה-API שלך.
```
  <script async defer
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
  </script>
```
לבדוק את התנועה ברשת שנוצרה על ידי האתר בדפדפן. אפשר לראות את ההגדרות האלה ב-Chrome בכרטיסייה רשת של DevTools. כאן יופיעו בקשות הרשת שנשלחו על ידי האתר שלכם. בקשות שמבוצעות באמצעות API של JavaScript של מפות Google יופיעו בנתיב maps/api/js. כאן אפשר לבדוק אם הבקשות משתמשות בפרמטר key. כדאי לסנן את התנועה ברשת לפי maps/api/js כשמעיינים בכרטיסייה רשת.

לא, אין לי מפתח API.

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

כן, יש לי מפתח API.

נהדר! בואו נמשיך ונבדוק אם משויך לפרויקט חשבון לחיוב.

האם מצורף חשבון לחיוב לפרויקט שלכם?

אין לי מושג איך אפשר לבדוק אם חשבון לחיוב מצורף לפרויקט?

נכנסים ל דף Billing במסוף Google Cloud ובוחרים את הפרויקט שבו נוצר מפתח ה-API. כדי לוודא שהמפתח משויך לפרויקט:

עוברים לקטע Credentials, שאליו אפשר להיכנס מהסרגל הצד השמאלי בקטע Google Maps Platform > Credentials (הפלטפורמה של מפות Google > פרטי כניסה).
בודקים שמפתח ה-API שבו אתם משתמשים כרגע באתר מופיע. אם זה לא המצב, עליכם לעבור לפרויקט אחר ולבדוק את פרטי הכניסה שם.
אם לא הצלחתם לאתר את הפרויקט עבור מפתח ה-API, יכול להיות שאיבדתם את הגישה לפרויקט הזה. תוכלו לבקש עזרה ממשתמשים אחרים בארגון. אם לא ניתן לאתר את הפרויקט המקורי, מבצעים את הפעולות הבאות:
1. יוצרים פרויקט חדש. כדי לעשות את זה, בוחרים באפשרות New Project (פרויקט חדש) ברשימת הפרויקטים, או בוחרים באפשרות Create Project בדף 'מנהל המשאבים'.
2. יוצרים מפתח API חדש. אפשר לעשות את זה בדף Credentials. אחרי שנכנסים לדף, לוחצים על Create credentials ואז על API key.

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

לא, לא מצורף חשבון לחיוב לפרויקט שלי.

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

כן, משויך לפרויקט שלי חשבון לחיוב.

נהדר! עליך לוודא שאמצעי החיוב שסיפקת חוקי.

האם שיטת החיוב שסיפקתם לא תקפה יותר (לדוגמה, כרטיס אשראי שפג תוקפו)?

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

האם יש חריגה מהמגבלה היומית שאתם מגדירים ב-API?

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

תוכלו לבדוק את המגבלות היומיות שלכם במרכז הבקרה של ממשקי ה-API והשירותים במסוף Cloud. אחרי שנכנסים לשם:

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

האם במפתח ה-API יש הגבלה על כתובות IP?

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

איך פותרים את קודי השגיאה: OVER_DAILY_LIMIT או OVER_QUERY_LIMIT?

אפשר להחזיר את קודי השגיאה האלה מהסיבות הבאות:

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

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

מגדירים חשבון לחיוב.
קבלת מפתח 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 ולנהל את ההגבלות:

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

איך פותרים את השגיאה: "לא ניתן להשתמש במפתחות API עם הגבלות של גורמים מפנים עם ה-API הזה"?

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

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

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

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

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

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

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

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

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

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

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

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

צריך לציין את הכתובות בהתאם לפורמט של שירות הדואר הלאומי במדינה הרלוונטית.
אל תציינו רכיבי כתובת נוספים כמו שמות עסק, מספרי יחידה, מספרי קומה או מספרי חדרים שלא נכללים בכתובת כפי שהוגדרה על ידי שירות הדואר במדינה הרלוונטית. פעולה זו עלולה להוביל לתשובות עם ZERO_RESULTS.
הפורמט של קודי OLC כפי שמוצג כאן (השלטים מופיעים עם תו בריחה (escape) של כתובת URL ל-%2B ורווחים באמצעות כתובת URL מסומנים בתו בריחה (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 הוא השם המלא של המדינה ו-NNN הוא המספר של הכביש המהיר. למשל, "California 82"
כבישים מהירים בארה"ב: "U.S. NNN" כאשר NNN הוא מספר הכביש המהיר. למשל "U.S. 101"
כבישים בין מדינות בארה"ב: "Interstate NNN" כאשר NNN הוא המספר בין המדינות, למשל, "Interstate 280"

מתי צריך להשתמש במחלקה לקואורדינטות (geocoding) של API ומתי כדאי להשתמש בשירות הקידוד הגיאוגרפי של HTTP?

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

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

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

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

באילו מדינות זמינים מסלולי נסיעה?

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

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

ה-Directions API ו-Distance Matrix API תומכים בכל השותפים של Google Transit, חוץ מהשותפים ביפן.

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

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

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

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

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

המחלקה KmlLayer שיוצרת שכבות-על של KML ב-JavaScript API של מפות 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. המידע הזה כולל את סטטוס ההצלחה, זמן האחזור והגרסה/הערוץ של API JavaScript של מפות Google שנמצאים בשימוש. יכול להיות שהשיחות יקובצו באצווה כדי לשפר את הביצועים. לתשומת ליבך, יכול להיות שיהיה עליך לאשר את maps.googleapis.com ב-Content Security Policy כדי לוודא שהשיחות האלה לא ייחסמו ברמת הדפדפן. לדוגמה: 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 לאחר טעינתו?: עליכם לרענן את הדף שטוען את Maps JavaScript API לפחות פעם ב-5 ימים.

SDK של מפות Google ל-iOS

איך פותרים את השגיאה: kGMSPlacesRateLimitExceeded?

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

מופיעות קריסות במהלך ניפוי באגים במכשיר iOS 8.x. מה אפשר לעשות?

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

ב-XCode, בוחרים באפשרות מוצר, סכמה, ניהול סכימות.
בוחרים סכמה ובוחרים באפשרות עריכה....
מגדירים את האפשרות GPU Frame Recording כהשבתה. שימו לב שהאפשרות הזו לא קיימת בכל המכשירים.

האפשרות של צילום פריימים באמצעות GPU של Xcode בדף הכללי של מכשיר iOS

מה ההשפעה של מסכים מעוגלים ורחבים יותר על ה-SDK של מפות Google ל-iOS?

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

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

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

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

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

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

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

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

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

SDK של מפות Google ל-Android

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

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

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

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

במניפסט יש הפניה למפתח API שגוי או לא מכוון.
אפשרות החיוב לא מופעלת בפרויקט.
ערכת ה-SDK לא מופעלת בממשקי API של הפרויקט.
טביעת האצבע השגויה ב-SHA1 נוספה להגבלות של מפתחות ה-API.
יחסי התלות של שירות Google Play לא כלולים בקובץ build.gradle.

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

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

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

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

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

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