מדיניות ושיוכים של Places API

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

מדיניות

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

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

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

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

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

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

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

בקטע הזה מפורטות הדרישות וההנחיות בנושא שיוך (Attribution) להצגת מפות 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

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

דרישות נוספות לגבי Places API

הדרישות הבאות ספציפיות ל-Places API.

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

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

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

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

תמונות וסקירות

ציון מחבר התוכן לכל התוכן

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

דרישות ויזואליות לייחוס היוצר:

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

גישה ישירה לתוכן המקור במפות Google

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

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

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

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

ביקורות

תארו איך הביקורות מסודרות ומסוננות

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

הודעה שמתארת את סדר הביקורות
דוגמה להודעה שמתארת את סדר הביקורות

הצגת החודש והשנה שבהם המבקרים ביקרו במקומות בצרפת

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

תאריך הביקור מוצג מתחת לביקורת של המשתמש
דוגמה לתאריך הביקור שמוצג מתחת לביקורת של משתמש

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

הודעת תרגום שמוצגת מתחת לביקורת של משתמש
דוגמה להודעת תרגום שמוצגת מתחת לביקורת של משתמש

ביקורות ודירוג ממוצע

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

דוגמה להודעה שמתארת את המדיניות של Google בנושא כתיבת ביקורות
דוגמה להודעה שמתארת את מדיניות בנושא כתיבת ביקורות של Google

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

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

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

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

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

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

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

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

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

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

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

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

הדרישות לסיכום של ביקורות

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

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

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

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

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

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

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

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

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

תוצאות חיפוש של מקומות

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

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

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

גילוי נאות לגבי תוצאות חיפוש של מקומות
תיבת דו-שיח שמתארת איך Google קובעת את הדירוג של תוצאות החיפוש

תאימות לדין החל

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