מדיניות ושיוכים ל-Maps JavaScript API

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

מדיניות

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

חריגים להגבלות על שמירה במטמון

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

גירוד תוכן (content scraping)

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

מדינות וטריטוריות באזור הכלכלי האירופי (EEA)

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

• התנאים וההגבלות של הפלטפורמה של מפות Google באזור הכלכלי האירופי
• התנאים הספציפיים לשירות של הפלטפורמה של מפות Google באזור הכלכלי האירופי
• שאלות נפוצות בנושא EEA
• הדרישות של Google Maps Platform בנושא בטיחות בדרכים

אם הכתובת שלכם לחיוב לא נמצאת ב-EEA, התנאים וההגבלות הבאים חלים עליכם:

• התנאים וההגבלות של Google Maps Platform
• התנאים הספציפיים לשירות של Google Maps Platform

דרישות הייחוס של מפות Google

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

דוגמה לשיוך (Attribution)

בהמשך מופיעה דוגמה לשיוך (Attribution) של Places UI Kit.

הצגת השיוך (Attribution) של מפות Google

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

הוספת שיוך למפות Google

לגבי שיוך למפות Google שכבר סופק על ידי Google Maps Platform בממשק המשתמש, כמו ב-Places UI Kit:

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

הלוגו של מפות Google ושיוך (Attribution) טקסט

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

שיוך הלוגו

הורדת סמלי הלוגו של מפות Google

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

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

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

מפרט הגודל של הלוגו

• גובה מינימלי של הלוגו: 16dp
• גובה מקסימלי של הלוגו: 19dp
• שטח פנוי מינימלי מסביב ללוגו: 10dp משמאל, מימין ומלמעלה, 5dp מלמטה

למידע נוסף על dp, אפשר לעיין בקטע צפיפות פיקסלים באתר Material Design.

נגישות של הלוגו

• חשוב לשמור על ניגודיות נגישה בין הלוגו לרקע.
• מוסיפים תווית נגישות עם הטקסט מפות 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 על ידי שיוך של תוכן שלא שייך ל-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,
});
index.js

לעיון במסמכי התיעוד בנושא ביקורות על מקומות

הצגת שיוך של תמונה

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

• עד 3 שורות
• עד 120 תווים או 24 מילים
• גודל גופן מינימלי של 24dp

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