‫ Places UI Kit: ספרייה מוכנה לשימוש שמאפשרת למפתחים להתאים אישית ולשלוט. כדאי לנסות ולשתף את המשוב שלך על חוויית השימוש בערכת ממשק המשתמש.

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

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

מדיניות

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

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

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

גירוד תוכן

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

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

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

אם הכתובת שלכם לחיוב לא נמצאת באזור הכלכלי האירופי, התנאים וההגבלות הבאים חלים עליכם:

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

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

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

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

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

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

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

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

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

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

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

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

ייחוס לוגו

אלה הדרישות לשימוש בלוגו של מפות Google באפליקציה או באתר שלכם.

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

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

הורדת נכסי השיוך של מפות Google

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

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

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

הלוגו של מפות Google צריך לעמוד במפרט הגודל הבא:

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

מידע על dp זמין במאמר Pixel density באתר Material Design.

נגישות הלוגו

הדרישות הבאות בנוגע לנגישות חלות על הלוגו של מפות Google:

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

טקסט לציון קרדיט

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

וריאציות קבילות של שיוך הטקסט במפות Google — דוגמאות לגרסאות קבילות של שיוך הטקסט למפות Google

אל תשנו את הטקסט מפות Google בשום צורה:
- אל תשנו את האותיות הרישיות במונח מפות Google
- לא להעביר את מפות Google לכמה שורות
- אל תתאימו את מפות Google לשוק המקומי בשפה אחרת.
- כדי למנוע מדפדפנים לתרגם את מפות Google, משתמשים במאפיין ה-HTML‏ translate="no".

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

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

בדוגמאות הבאות אפשר לראות איך הדרישות האלה נראות.

דוגמה לשיוך למפות Google שמוצג בחלק העליון, בתחתית ובצד של התוכן — דוגמה לציון המקור של מפות Google במיקום בחלק העליון, בחלק התחתון ובצד של התוכן

דוגמה לשתי גישות להבדלה בין תוכן במפות Google (דירוג המקום) לבין תוכן אחר — דוגמה לשתי גישות להבדלה בין תוכן של מפות Google (דירוג המקום) לבין תוכן אחר

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

ספקי נתונים של צד שלישי

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

בדוגמה הבאה מוצג תהליך של קבלת מקום, בדיקה אם יש ביקורות והצגת הנתונים מהביקורת הראשונה:

  // Use place ID to 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"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }

מידע נוסף על ביקורות על מקומות

הצגת שיוכים לתמונה

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

כל רכיב במערך photos הוא מופע של Photo, שמכיל את המערך authorAttributions מסוג AuthorAttribution. השדות של האובייקט AuthorAttribution הם מחרוזות שמכילות את displayName,‏ uri ו-photoUri של השיוך, או מחרוזת ריקה אם אין שיוכים להצגה.

מידע נוסף על תמונות של מקומות

שיוכים של תוצאות חיפוש

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

כותרת: מידע על התוצאות האלה

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

לחצן 1: מידע נוסף
הטקסט 'מידע נוסף' צריך לקשר למאמר במרכז העזרה.

Button 2: OK

השלמה אוטומטית של כתובות של משתמשי קצה

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

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

סיכומים מבוססי-AI

אם אתם מציגים סיכומים מבוססי-AI באפליקציה שלכם – כולל סיכומים של מקומות, אזורים וביקורות – אתם חייבים:

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

הצגת טקסט גילוי נאות לגבי סיכומים מבוססי-AI

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

גילוי נאות לכל סוגי הסיכומים מבוססי-AI — **איור 1**: טקסט הגילוי הנאות מוצג בצורה תקינה מתחת לכל אחד משלושת סוגי הסיכומים מבוססי-AI.

דרישות נוספות לגבי סיכום של מקום או אזור

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

טקסט דרישה

מידע על הסיכום הזה כדאי לעיין בקישור הבא בנושא 'מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות': https://support.google.com/local-listings/answer/9851099.

סיכום הדוח

טקסט	דרישה
מידע על הסיכום הזה	כדאי לעיין בקישור הבא בנושא 'מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות': https://support.google.com/local-listings/answer/9851099.
סיכום הדוח	כדי לדווח ל-Google על בעיה שקשורה לתוכן של סיכום, אפשר להשתמש בקישור שמופיע בשדה `flagContentUri` של התשובה. הערה: סיכומים מבוססי-AI שמוצגים באמצעות Places API (חדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. אתם נדרשים להודיע למשתמשי הקצה שלכם שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL של הכלי לסימון תוכן (`flagContentUri`).

כדי לדווח ל-Google על בעיה שקשורה לתוכן של סיכום, אפשר להשתמש בקישור שמופיע בשדה flagContentUri של התשובה.

הערה: סיכומים מבוססי-AI שמוצגים באמצעות Places API (חדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. אתם נדרשים להודיע למשתמשי הקצה שלכם שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL של הכלי לסימון תוכן (flagContentUri).

גילוי נאות לגבי סיכומים של מקומות ואזורים — **איור 2**: סיכום אזור מבוסס-AI שמוצג עם קישורים נדרשים שקשורים לנושא, שזמינים למשתמשי הקצה באמצעות תפריט אפשרויות נוספות.

דרישות לגבי סיכומי ביקורות

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

טקסט דרישה

מידע על הסיכום הזה בקישור הבא מוסבר "מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות": https://support.google.com/local-listings/answer/9851099

סיכום הדוח

טקסט	דרישה
מידע על הסיכום הזה	בקישור הבא מוסבר "מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות": https://support.google.com/local-listings/answer/9851099
סיכום הדוח	משתמשים בקישור שמופיע בשדה `flagContentUri` בתשובה. הערה: סיכומים מבוססי-AI שמוצגים באמצעות Places API (חדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. אתם נדרשים להודיע למשתמשי הקצה שלכם שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL של הכלי לסימון תוכן (`flagContentUri`).
לצפייה בביקורות	משתמשים בקישור שמופיע בשדה `reviewSummary.reviewsUri` בתשובה.

משתמשים בקישור שמופיע בשדה flagContentUri בתשובה.

לצפייה בביקורות משתמשים בקישור שמופיע בשדה reviewSummary.reviewsUri בתשובה.

גילוי נאות לגבי סיכומי ביקורות — **איור 3**: סיכום ביקורות מבוסס-AI שמוצג עם קישורים נלווים נדרשים שזמינים למשתמשי הקצה באמצעות תפריט אפשרויות נוספות.

הנחיות לגבי תרחישי שימוש בתחום הרכב

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

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

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

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

מדיניות

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

גירוד תוכן

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

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

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

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

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

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

ייחוס לוגו

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

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

נגישות הלוגו

טקסט לציון קרדיט

דוגמה ל-CSS

דרישות ויזואליות

ספקי נתונים של צד שלישי

דרישות אחרות לייחוס

אחזור שיוכים ממקום

הצגת ביקורת

הצגת שיוכים לתמונה

שיוכים של תוצאות חיפוש

השלמה אוטומטית של כתובות של משתמשי קצה

סיכומים מבוססי-AI

הצגת טקסט גילוי נאות לגבי סיכומים מבוססי-AI

דרישות נוספות לגבי סיכום של מקום או אזור

דרישות לגבי סיכומי ביקורות

הנחיות לגבי תרחישי שימוש בתחום הרכב

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