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

Switch to English

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

תחילת העבודה

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

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

מפות:

מסלולים:

מקומות:

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

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

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

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

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

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

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

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

מאמרים קשורים:

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

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

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

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

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

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

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

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

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

ה-JavaScript 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

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

האם אפשר להדפיס מפות מ-Maps JavaScript API?

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

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

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

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

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

מתי התמיכה הטכנית זמינה?

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

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

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

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

האם אפשר לגשת ישירות לכרטיסי מפה ולתמונות לוויין?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API	מגבלת שימוש
אימות כתובת	6000 QPM
מסלול	50 QPS
מטריצת מרחק	1,000 EPS
מפות דינמיות	500 QPS
גובה	100 QPS
המרת כתובות לקואורדינטות (geocoding)	50 QPS
מיקום גיאוגרפי	100 QPS
מקומות	100 QPS
כבישים	500 QPS
מסלולים: Compute Routes	3000 QPM
מסלולים: מטריצת מסלול מחשוב	3,000 EPM
מפות סטטיות	500 QPS
ממשק API של תמונות מראה הרחוב	500 QPS
אזור זמן	500 QPS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

API/SDK	הגבלת אישורים ואפליקציות
SDK SDK ל-Android	מפתח API עם הגבלת Android¹
מקומות SDK ל-Android	מפתח API עם הגבלת Android¹
SDK של מפות ל-iOS	מפתח API עם הגבלת iOS¹
SDK של מקומות ל-iOS	מפתח API עם הגבלת iOS¹
Maps JavaScript API	מפתח API עם הגבלת גורם מפנה של HTTP¹
API סטטי של מפות Google	מפתח API עם הגבלה של גורם מפנה מסוג HTTP¹ + חתימה דיגיטלית²
ממשק API של Street View סטטי	מפתח API עם הגבלה של גורם מפנה מסוג HTTP¹ + חתימה דיגיטלית²
ממשק API להטמעה של מפות Google	מפתח API עם הגבלת גורם מפנה של HTTP¹
ממשק API לאימות כתובות	מפתח API עם הגבלת כתובת IP¹
הוראות ל-API	מפתח API עם הגבלת כתובת IP¹
DISTANCE Matrix API	מפתח API עם הגבלת כתובת IP¹
ממשק API של הרמה	מפתח API עם הגבלת כתובת IP¹
ממשק API לקידוד גיאוגרפי	מפתח API עם הגבלת כתובת IP¹
ממשק API של מיקומים גיאוגרפיים	מפתח API עם הגבלת כתובת IP¹
מקומות API	מפתח API עם הגבלת כתובת IP¹
APIs של כבישים	מפתח API עם הגבלת כתובת IP¹
API לנתיבים	מפתח API עם הגבלת כתובת IP¹
ממשק API של Time Zone	מפתח API עם הגבלת כתובת IP¹

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

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

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

קוד שפה	שפה	קוד שפה	שפה
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)?

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

שימו לב ש-Maps Static API לא תומך בכתובות URL של סמלים מותאמים אישית שנעשה בהן שימוש ב-HTTPS. סמל ברירת המחדל יופיע במסך.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בחרת להשתמש במפתח API?

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

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

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

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

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

אם יש לך גישה לקוד המקור של האפליקציה, עליך לחפש את התג <script> המשמש לטעינת ה-API של מפות Google ל-JavaScript. כשטוענים את JavaScript JavaScript API, יש להחליף את 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 ב-Maps ייכללו בנתיב maps/api/js. כאן אפשר לבדוק אם הבקשות משתמשות בפרמטר key. מומלץ לסנן את התנועה ברשת לפי maps/api/js בזמן הצפייה בכרטיסייה רשת.

לא, אני לא משתמש במפתח API.

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

כן, אני משתמש במפתח API.

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

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

אני לא בטוח/ה. איך אפשר לבדוק אם החשבון לחיוב מצורף לפרויקט?

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

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

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

לא, לחשבון החיוב שלי לא מצורף חשבון לחיוב.

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

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

נהדר! יש לוודא ששיטת החיוב שצוינה חוקית.

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

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

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

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

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

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

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

ניתן להשתמש במפתחות API עם הגבלה של כתובות IP רק עם שירותי אינטרנט שמיועדים לשימוש בצד השרת (כמו API לקידוד גיאוגרפי וממשקי API אחרים של שירות אינטרנט). ברוב שירותי האינטרנט האלה יש שירותים מקבילים בתוך JavaScript JavaScript API (למשל, שירות Geocoding). כדי להשתמש בשירותים הצדדיים של לקוח JavaScript API של 'מפות Google', עליך ליצור מפתח 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 או SDK של מקומות ל-iOS. למידע נוסף ולמצוא את ערכות ה-SDK החדשות בכתובת https://goo.gle/places-sdk-deprecation.

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

יש תרחישים שונים שעלולים לגרום לשגיאה הזו:

הפעלת הגבלות של כתובת IP (שרת) במפתח ה-API שלך, וכתובת IP לא מורשית מנסה לשלוח בקשה.
הפעלת הגבלות על הגורם המפנה של HTTP (אתר) במפתח ה-API שלך, וגורם מפנה לא מורשה מנסה לשלוח בקשה.
הגבלת את השימוש באפליקציות ל-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 חדש אם המפתח כבר נמצא בשימוש ב-API של JavaScript ב-Maps.

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

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

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

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

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

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

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

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

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

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

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

יש לציין את הכתובות בהתאם לפורמט של שירות הדואר הארצי של המדינה הרלוונטית.
אין לציין רכיבי כתובת נוספים כמו שמות עסקים, מספרי יחידות, מספרי קומה או מספרי סוויטות שאינם כלולים בכתובת, כפי שהוגדר על ידי שירות הדואר של המדינה הרלוונטית. המשך הפעולה עשוי להוביל לתגובות עם ZERO_RESULTS.
צריך להזין את קודי ה-Plus כפי שמוצג כאן (הסימן + מקודד את כתובת ה-URL עם תווי בריחה ל-%2B ורווחים מסומנים בתו בריחה ל-%20):
- קוד גלובלי הוא קוד אזור בן 4 תווים וקוד מקומי באורך 6 תווים או יותר (849VCWC8+R9 הוא 849VCWC8%2BR9).
- קוד מורכב הוא קוד מקומי בן 6 תווים או יותר, עם מיקום מפורש (CWC8+R9 Mountain View, CA, ארה"ב הוא 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"

מתי כדאי להשתמש בשיעור של מקודד API בממשק API ומתי כדאי להשתמש בשירות הקידוד הגיאוגרפי של HTTP?

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

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

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

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

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

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

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

ה-API API למסלולים וה-API Matrix API תומכים בכל שותפי Google Transit, מלבד שותפים ביפן.

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

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

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

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

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

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

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

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

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

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

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

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

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

שליחת משוב דרך מפות Google עם מידע שגוי או חסר במפה, כמו:

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

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

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

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

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

תכונות מסוימות בצד הלקוח משמשות לדיווח על הצלחה או כישלון במטרה לחשב את יעד רמת השירות (SLO). המידע הזה נשלח אל Google במספר maps.googleapis.com/maps_api_js_slo/log בשיחות שמתעדות מידע על רמת השירות. המידע הזה כולל סטטוס הצלחה, זמן אחזור וגרסה/ערוץ של ה-API של JavaScript 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 של מפות Google JavaScript לאחר שייטען?: עליכם לרענן את הדף שטוען את JavaScript JavaScript API לפחות פעם ב-5 ימים.

SDK של מפות Google ל-iOS

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

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

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

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

ב-XCode, בוחרים באפשרות Product , Scheme או Manage Schemes.
בוחרים סכמה ובוחרים באפשרות עריכה....
מגדירים את האפשרות GPU Framework Captureמושבתת. חשוב לזכור שאפשרות זו לא תופיע בכל המכשירים.

אפשרות ל-Xcode של תיעוד מסגרת GPU בדף של מכשיר iOS כללי

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

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

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

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

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

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

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

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

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

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

SDK של מפות Google ל-Android

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

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

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

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

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

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

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

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

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

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

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