במסמך הזה מפורטות הדרישות לאפליקציות שפותחו באמצעות Maps JavaScript API. חשוב לזכור שהשימוש ב-Maps JavaScript API כפוף להסכם שלכם עם Google.
מדיניות
בקטע הזה מתוארות כללי המדיניות שרלוונטיים ל-Maps JavaScript API. המדיניות מספקת הנחיות ודרישות מעשיות להטמעה, כדי לעזור לכם להשתמש בשירות בצורה נכונה ובהתאם לציפיות של Google Maps Platform.
אחסון נתונים, שמירה במטמון וגירוד נתונים (scraping)
כשמשתמשים בתוכן של מפות Google באפליקציה, צריך לפעול בהתאם לדרישות הטיפול בנתונים שמפורטות בסעיף 3.2.3 בתנאים ובהגבלות של Google Maps Platform ובתנאים הספציפיים לשירות של Google Maps Platform:
- הגבלות על שמירה במטמון ועל גירוד נתונים (סעיפים 3.2.3(א) ו-(ב)): מותר לשמור במטמון או לאחסן תוכן של מפות Google רק כפי שמותר במפורש בתנאים הספציפיים לשירות של Google Maps Platform. אסור לייצא, לחלץ או לגרד תוכן ממפות Google לשימוש מחוץ לשירותים. לדוגמה, אסור לאחזר מראש, להוסיף לאינדקס, לאחסן או להפיץ מחדש תוכן של מפות Google מחוץ לשירותים, להוריד בכמות גדולה משבצות מפה, תמונות Street View, קואורדינטות, מסלולים, תוצאות של מטריצת מרחקים, מידע על כבישים, מידע על מקומות, ערכי גובה או פרטים של אזורי זמן, או להעתיק ולשמור שמות של עסקים, כתובות או ביקורות של משתמשים.
- הגבלות תוכן נגזר (סעיף 3.2.3(c)): השתמש בתוכן של מפות Google בתוך האפליקציה שלך כפי שמותר על פי תנאי השירות של Google Maps Platform. אל תיצרו תוכן שמבוסס על תוכן ממפות Google. לדוגמה, אסור לעקוב אחרי מאפיינים מצילומי לוויין או להמיר אותם לפורמט דיגיטלי, לבנות מודלים תלת-ממדיים או מודלים של פני שטח, להשתמש בערכי קווי הרוחב והאורך של מקומות כקלט לניתוח נקודה-בפוליגון, לבנות אינדקס מיקומים מתמונות Street View או להמיר זמני נסיעה מבוססי-טקסט לדיבור מסונתז.
כדי לצמצם את זמן האחזור ואת עלויות החיוב בלי לשמור במטמון נתונים מוגבלים, אפשר להשתמש במסכות שדות או ברשימות שדות כדי לבקש רק את השדות שממשק המשתמש צריך. אחסון מזהים פטורים כמו מזהה המקום כדי לאחזר פרטים עדכניים כשמשתמש יוצר אינטראקציה עם מקום.
מהנדסי התמיכה הטכנית של Google לא יכולים לספק ייעוץ משפטי או לאשר חריגות מהתנאים ומההגבלות של Google Maps Platform. כדי לבדוק אם ההטמעה שלכם עומדת בתנאים, אתם צריכים להתייעץ עם היועץ המשפטי שלכם. אם תרחיש השימוש שלכם דורש רישיון בהתאמה אישית, אתם יכולים לפנות למכירות.
חריגים להגבלות על שמירה במטמון
בתנאים הספציפיים לשירות של Google Maps Platform מפורטים החריגים הבאים שבהם מותר לשמור נתונים במטמון:
- מזהי מקומות: מזהה המקום, שמשמש לזיהוי ייחודי של מקום, פטור מהגבלות השמירה במטמון.
לכן, אתם יכולים לאחסן ערכים של מזהי מקומות ללא הגבלת זמן. מזהי המקומות מוחזרים בשדה
idאו בשדהplace_idבתגובות מה-API. במדריך למזהי מקומות מוסבר איך לשמור, לרענן ולנהל מזהי מקומות. - קואורדינטות של קו רוחב וקו אורך: אתם יכולים לשמור באופן זמני במטמון ערכים של קו רוחב (
latitude) וקו אורך (longitude) למשך עד 30 ימים קלנדריים רצופים. לאחר מכן, אתם צריכים למחוק את הקואורדינטות שנשמרו במטמון, כשאתם משתמשים בשירותים שמעניקים את החריגה הזו בתנאים הספציפיים לשירות של Google Maps Platform:- Routes API, Route Optimization API, Directions API (דור קודם) ו-Roads API
- Geocoding API, Geolocation API ו-Address Validation API
- Places API, Places UI Kit ו-Navigation SDK
- תקופות שמירה במטמון ספציפיות לשירות: בתנאים הספציפיים לשירות של Google Maps Platform מוגדרות גם תקופות שמירה במטמון ספציפיות לשדות ומטרות מותרות ל-Address Validation API, ל-Air Quality API, ל-Pollen API, ל-Solar API, ל-Weather API ול-Places Aggregate API.
גירוד תוכן (content scraping)
יכול להיות ששם המקום יוחזר אליכם על סמך האינטראקציות של המשתמשים עם האפליקציה. אם תתעדו או תשמרו את שם המקום לשימוש בהקשר אחר מחוץ לסשן של המשתמש, הפעולה הזו תיחשב כגירוד מידע (scraping), וזה אסור לפי התנאים שלנו.
מדינות וטריטוריות באזור הכלכלי האירופי
למוצר הזה יש תנאים והגבלות שונים ללקוחות עם כתובת לחיוב באזור הכלכלי האירופי (EEA), ויכול להיות שגם הפונקציונליות שלו שונה. לפני שמתחילים לפתח באמצעות הפלטפורמה של מפות Google, חשוב לקרוא את התנאים והמידע הבאים שרלוונטיים ל-EEA:
- התנאים וההגבלות של הפלטפורמה של מפות Google באזור הכלכלי האירופי
- התנאים הספציפיים לשירות של הפלטפורמה של מפות Google באזור הכלכלי האירופי
- שאלות נפוצות בנושא EEA
- הדרישות של Google Maps Platform בנושא בטיחות בדרכים
אם הכתובת שלכם לחיוב לא נמצאת ב-EEA, התנאים וההגבלות הבאים חלים עליכם:
דרישות הייחוס של מפות Google
בקטע הזה מפורטות הדרישות וההנחיות בנושא ייחוס להצגת מפות Google ותוכן דרך האפליקציות שלכם.
דוגמה לשיוך (Attribution)
בהמשך מוצגת דוגמה לשיוך (Attribution) ב-Places UI Kit.
הצגת השיוך למפות Google
כשמציגים תוכן מממשקי ה-API של Google Maps Platform באפליקציה או באתר, צריך לפעול בהתאם לדרישות הייחוס של מפות Google. אין צורך להוסיף שיוך נוסף אם התוכן מוצג במפות Google והשיוך כבר גלוי.
הוספת שיוך למפות Google
אם Google Maps Platform כבר מספקת את הייחוס למפות Google בממשק המשתמש, למשל ב-Places UI Kit:
- אל תסירו את השיוך (Attribution) שכלול, לא משנה איפה הוא מוצג. אסור לשנות, להסתיר או לטשטש את השיוך, וצריך לוודא שהוא מוצג בבירור על הרקע.
- תמיד צריך להבחין באופן חזותי בין תוכן של Google Maps Platform לבין תוכן אחר באמצעות רמזים בממשק המשתמש, כמו גבול, צבע רקע, צל או רווח לבן מספיק.
- כשמבצעים שינויים חזותיים, צריך לעמוד בכל דרישות הייחוס של מפות Google.
הלוגו של מפות Google ושיוך (Attribution) טקסט
במידת האפשר, השיוך צריך להיות בצורת הלוגו של מפות Google. במקרים שבהם המקום מוגבל, אפשר להשתמש בטקסט מפות Google. למשתמשי הקצה תמיד צריך להיות ברור איזה תוכן מסופק על ידי מפות Google.
שיוך הלוגו
כדי להשתמש בלוגו של מפות Google באפליקציה או באתר, צריך לפעול לפי הדרישות הבאות.הורדת סמלי לוגו של מפות Google
השתמשו בקובצי הלוגו הרשמיים של מפות Google. אתם יכולים להוריד את סמלי הלוגו שבהמשך ולפעול לפי ההנחיות שבקטע הזה.
הורדת נכסי השיוך של מפות Googleכשמשתמשים בלוגו של מפות Google, צריך לפעול לפי ההנחיות הבאות.
- אסור לשנות את הלוגו בשום צורה.
- כדי למנוע עיוות, חשוב לשמור על יחס הגובה-רוחב של הלוגו.
- השתמשו בלוגו עם קווי המתאר על רקע עמוס, כמו מפה או תמונה.
- השתמשו בלוגו ללא קווי מתאר על רקע פשוט, כמו צבע אחיד או מעבר צבעים עדין.
מפרט הגודל של הלוגו
הלוגו של מפות Google צריך לעמוד במפרט הגודל הבא:- גובה מינימלי של הלוגו: 16dp
- גובה מקסימלי של הלוגו: 19dp
- שטח פנוי מינימלי מסביב ללוגו: 10dp משמאל, מימין ומלמעלה, 5dp מלמטה
כדי לקבל מידע על dp, אפשר לעיין בקטע צפיפות פיקסלים באתר Material Design.
נגישות הלוגו
כדי להשתמש בלוגו של מפות Google, צריך לעמוד בדרישות הנגישות הבאות:- שומרים על ניגודיות נגישה בין הלוגו לרקע.
- מוסיפים תווית נגישות עם הטקסט מפות Google.
שיוך טקסט
אם גודל הממשק שלכם לא מאפשר להשתמש בלוגו של מפות Google, אתם יכולים לכתוב מפות Google בטקסט. בצע את ההנחיות הבאות:
- אין לשנות את הטקסט מפות Google בשום צורה:
- אל תשנו את האותיות הרישיות ב-Google Maps.
- אל תעבירו את מפות Google לשורות מרובות
- אל תתרגמו את מפות Google לשפה אחרת.
- כדי למנוע מדפדפנים לתרגם את מפות Google, משתמשים במאפיין ה-HTML
translate="no".
כדי לעצב את הטקסט במפות Google, צריך לפעול לפי ההוראות בטבלה הבאה:
הדרישות של מפות Google בנוגע לסגנון הטקסט נכס סגנון משפחת גופנים Roboto. לא חובה לטעון את הגופן. משפחת גופנים חלופית כל גופן Sans Serif שכבר נמצא בשימוש במוצר, או "Sans-Serif" כדי להפעיל את גופן ברירת המחדל של המערכת סגנון הגופן רגיל עובי הגופן 400 צבע גופן לבן, שחור (#1F1F1F) או אפור (#5E5E5E). לשמור על ניגודיות נגישה (4.5:1) ביחס לרקע. גודל גופן גודל גופן מינימלי: 12sp
גודל גופן מקסימלי: 16sp
מידע ולמידה על sp זמין בקטע יחידות של גודל גופן באתר Material Design.ריווח בין אותיות רגיל
דוגמה ל-CSS
ה-CSS הבא מעבד את מפות Google עם הסגנון הטיפוגרפי והצבע המתאימים על רקע לבן או בהיר.
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap'); .GMP-attribution { font-family: Roboto, Sans-Serif; font-style: normal; font-weight: 400; font-size: 1rem; letter-spacing: normal; white-space: nowrap; color: #5e5e5e; }
דרישות בנושא רכיבים חזותיים
כדי להציג את השיוך למפות Google, צריך לפעול לפי הדרישות הבאות.הציבו את השיוך קרוב לחלק העליון או התחתון של התוכן, ובתוך אותו מאגר חזותי. אם התוכן הוא שורה אחת, אפשר למקם את השיוך מימין או משמאל.
כדי להבדיל באופן חזותי בין תוכן Google Maps Platform לבין תוכן אחר, צריך להשתמש ברמזים בממשק המשתמש, כמו גבול, צבע רקע, צל או מספיק שטח לבן.
- אסור להציג מצג שווא לגבי מפות Google על ידי שיוך של תוכן שלא שייך ל-Google Maps Platform.
- מוודאים שהשיוך תמיד גלוי וקריא. אסור להסיר, להסתיר, לטשטש או לשנות אותו.
התמונות הבאות מציגות דוגמאות לדרישות החזותיות האלה.
ספקי נתונים של צד שלישי
חלק מהנתונים והתמונות במוצרי המפות שלנו מגיעים מספקים שאינם Google. במוצרים מסוימים, כמו Map Tiles API, יכול להיות שנספק לכם את השיוך הנדרש לספק הנתונים של הצד השלישי. במקרה כזה, הטקסט של השיוך חייב לכלול את השם "מפות Google" ואת ספקי הנתונים הרלוונטיים, למשל "נתוני מפה: Google, Maxar Technologies". כש-Google מספקת ייחוס לצד שלישי, הוספה של "מפות Google" או של הלוגו של Google בלבד לא נחשבת לייחוס תקין.
דרישות אחרות בנוגע לייחוס
כדי לאחזר שיוכים של צד שלישי ולהציג אותם באפליקציה, פועלים לפי ההוראות הבאות.
אחזור של פרטי זכויות יוצרים ממקום
אם האפליקציה מציגה מידע על ביקורות שהתקבלו באמצעות קריאה ל-Place.fetchFields, היא צריכה להציג גם את הייחוסים של הצדדים השלישיים לפרטי המקום שהתקבלו.
ה-API מחזיר אובייקט Place. כדי לאחזר שיוכים מהאובייקט Place, משתמשים במאפיין Place.attributions שמוחזר עם כל בקשה (אין צורך לציין אותו בשדות). המאפיין מחזיר List של אובייקטים מסוג String, או null אם אין שיוכים להצגה. הקוד לדוגמה הבא מראה איך לקבל מקום ולהציג את כל השיוכים.
// Use place ID to create a new Place instance. const place = new Place({ id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen }); // Call fetchFields, passing the desired data fields. await place.fetchFields({ fields: ["displayName", "formattedAddress", "location", "reviews"], }); // Check for any place attributions. if (!place.attributions) { console.log('No attributions were found.'); return; } else { // Log the place attribution for (var attribution of place.attributions) { console.log(attribution); } }
הצגת ביקורת
אובייקט Place יכול להכיל עד חמש ביקורות, כשכל ביקורת מיוצגת על ידי אובייקט Review. אתם יכולים להציג את הביקורות האלה באפליקציה שלכם.
כשמציגים ביקורות שמשתמשי Google הוסיפו, צריך להציג את שם הכותב בסמוך לביקורת. אם שדה שיוך המחבר של האובייקט Review זמין, מומלץ לכלול גם את תמונת המחבר וקישור לפרופיל שלו. בתמונה הבאה מוצגת דוגמה לביקורת על פארק:
בדוגמה הבאה מוצג איך לקבל מקום, לבדוק אם יש ביקורות ולהציג את הנתונים מהביקורת הראשונה:
// Create a new Place instance. const place = new Place({ id: 'ChIJpyiwa4Zw44kRBQSGWKv4wgA', // Faneuil Hall Marketplace, Boston, MA }); // Call fetchFields, passing 'reviews' and other needed fields. await place.fetchFields({ fields: ['displayName', 'formattedAddress', 'location', 'reviews'], }); // Create an HTML container. const content = document.createElement('div'); const title = document.createElement('div'); const rating = document.createElement('div'); const address = document.createElement('div'); const review = document.createElement('div'); const authorLink = document.createElement('a'); // If there are any reviews display the first one. if (place.reviews && place.reviews.length > 0) { // Get info for the first review. const reviewRating = place.reviews[0].rating; const reviewText = place.reviews[0].text; const authorName = place.reviews[0].authorAttribution.displayName; const authorUri = place.reviews[0].authorAttribution.uri; // Safely populate the HTML. title.textContent = place.displayName || ''; address.textContent = place.formattedAddress || ''; rating.textContent = `Rating: ${reviewRating} stars`; review.textContent = reviewText || ''; authorLink.textContent = authorName; authorLink.href = authorUri || ''; authorLink.target = '_blank'; content.appendChild(title); content.appendChild(address); content.appendChild(rating); content.appendChild(review); content.appendChild(authorLink); } else { content.textContent = `No reviews were found for ${place.displayName}.`; } // Create an infoWindow to display the review. infoWindow = new InfoWindow({ content, ariaLabel: place.displayName, });
לעיון במסמכי התיעוד בנושא ביקורות על מקומות
הצגת שיוכים של תמונה
אם האפליקציה מציגה תמונות, צריך להציג את השיוך למחבר של כל תמונה שיש לה שיוך כזה.
פרטים על התמונה באובייקט Place של התגובה כלולים במערך photos. כדי להוסיף את המערך photos לתגובה, צריך לכלול את שדה הנתונים photos בבקשה.
כל רכיב במערך התמונות הוא מופע של Photo, שמכיל את המערך authorAttributions מסוג AuthorAttribution. השדות של האובייקט AuthorAttribution הם מחרוזות שמכילות את displayName, uri ו-photoUri של השיוך, או מחרוזת ריקה אם אין שיוכים להצגה.
לעיון במסמכי התיעוד בנושא תמונות של מקומות
ייחוסים של תוצאות חיפוש
באירופה, כשמשתמשים בדירוג הלא משופר של Google, מוצרי החיפוש חייבים לכלול טקסט הסבר במרחק של קליק אחד לכל היותר, שמתאר את הגורמים העיקריים ואת השקלול של הגורמים העיקריים שקובעים את דירוג תוצאות החיפוש. טקסט הסבר:
כותרת: מידע על התוצאות האלה
גוף הטקסט: כשמחפשים עסקים או מקומות ליד מיקום מסוים, מוצגות במפות Google תוצאות מהסביבה הקרובה. שילוב של כמה גורמים – בעיקר רלוונטיות, מרחק וחשיבות – עוזר להשיג את התוצאות הטובות ביותר בחיפוש.
כפתור 1: מידע נוסף
הטקסט "מידע נוסף" צריך לקשר למאמר במרכז העזרה.
כפתור 2: אישור
השלמה אוטומטית של כתובות של משתמשי קצה
כשמשתמש קצה משתמש בפונקציונליות של השלמה אוטומטית באפליקציית הלקוח כדי להקליד כתובת רחוב, והכתובת הזו הייתה מסופקת באופן מלא ומדויק על ידי משתמש הקצה גם בלי השלמה אוטומטית, הכתובת שנבחרה על ידי משתמש הקצה לא כפופה להגבלות התוכן של מפות Google בהסכם שלך עם Google Maps Platform. החריג הזה חל רק על כתובת הרחוב שנבחרה על ידי משתמש הקצה ורק על העסקה הספציפית של אותו משתמש קצה. הוא לא חל על רשימת הכתובות המוצעות שסופקה על ידי פונקציונליות ההשלמה האוטומטית או על תוכן אחר של מפות Google. החריג הזה לא חל על פונקציונליות של חיפוש נקודות עניין או כתובות שמוצעת על ידי שירותים אחרים של Google Maps Platform.
בתמונה הקודמת, רשימת הכתובות שמימין עדיין כפופה להגבלות על התוכן של מפות Google. אחרי שמשתמש הקצה בוחר את הכתובת הרצויה, הכתובת הזו לא כפופה להגבלות על תוכן של מפות Google, אך ורק לצורך העסקה הרלוונטית של אותו משתמש קצה.
סיכומים מבוססי-AI
כשמציגים באפליקציה סיכומים מבוססי-AI, כולל סיכומים של מקומות, אזורים וביקורות, צריך:
- להציג את השיוכים הנדרשים, הקישורים לדיווח והקישורים להפניה כפי שמוגדר בהמשך.
- משתמשי הקצה חייבים להיות מסוגלים לקרוא את הטקסט המלא של הסיכום כפי שהוא מסופק על ידי מפות Google.
הצגת טקסט הגילוי הנאות לגבי סיכומים מבוססי-AI
כשמציגים סיכום מכל סוג מבוסס-AI, צריך תמיד לכלול את טקסט הגילוי הנאות המותאם לשוק המקומי (שמצוין בשדה disclosureText בגוף התשובה) מיד מתחת לסיכום. אסור לשנות או להוסיף לטקסט הגילוי הנאות שסופק על ידי ה-API.
דרישות נוספות לגבי סיכומי מקומות ואזורים
תקצירי מקומות ותקצירי אזורים שמוצגים באפליקציה חייבים לכלול את הטקסט והקישורים הנדרשים הבאים:
| טקסט | דרישה |
|---|---|
| מידע על הסיכום הזה | הקישור הבא מוביל למאמר "מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות": https://support.google.com/local-listings/answer/9851099. |
| סיכום הדוח |
כדי לדווח ל-Google על בעיה בתוכן של סיכום, משתמשים בקישור שמופיע בשדה הערה: סיכומים מבוססי-AI שנוצרים באמצעות Places API (החדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. אתם נדרשים להודיע למשתמשי הקצה שלכם שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL שסופקה לדיווח על תוכן ( |
הדרישות לגבי סיכום של ביקורות
סיכום של ביקורות שמוצגים באפליקציה חייבים לכלול כותרת עם הטקסט "סיכום של ביקורות". בנוסף, צריך להשתמש בטקסט ובקישורים הנדרשים הבאים:
| טקסט | דרישה |
|---|---|
| מידע על הסיכום הזה | הקישור הבא מוביל למאמר "מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות": https://support.google.com/local-listings/answer/9851099 |
| סיכום הדוח |
משתמשים בקישור שמופיע בשדה הערה: סיכומים מבוססי-AI שנוצרים באמצעות Places API (החדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. אתם נדרשים להודיע למשתמשי הקצה שלכם שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL שסופקה לדיווח על תוכן ( |
| לצפייה בביקורות | משתמשים בקישור שמופיע בשדה reviewSummary.reviewsUri בתגובה. |
הצגת הנחיות לתרחישי שימוש ברכב
כדי לשמור על בטיחות הנהג, Google ממליצה להציג סיכומים מבוססי-AI במצב חנייה ברכבים. אם מציגים סיכומים במצב נהיגה, המידע במסך צריך להיות פשוט, ברור ותמציתי כדי להבטיח שתשומת הלב של הנהג תחזור במהירות לכביש:
- עד 3 שורות
- עד 120 תווים או 24 מילים
- גודל גופן מינימלי של 24dp
במיוחד בהקשרים של כלי רכב, המפתח אחראי להציג סיכומים מבוססי-AI בדרכים בטוחות ותואמות לכל החוקים והתקנות המקומיים.