מדיניות ושיוכים של 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

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

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

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

מימין: שיוך טקסטואלי למפות Google, משמאל: שיוך לוגו למפות Google
מימין: שיוך טקסט ל-Google Maps, משמאל: שיוך לוגו ל-Google Maps

ייחוס ללוגו

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

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

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

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

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

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

חלק מהנתונים והתמונות במוצרי המיפוי שלנו מגיעים מספקים שאינם Google. במוצרים מסוימים, כמו Map Tiles API, אנחנו עשויים לספק לכם את הקרדיט הנדרש לספק הנתונים מצד שלישי. במקרה כזה, בטקסט של השיוך צריך להופיע השם 'מפות Google' ושמות ספקי הנתונים הרלוונטיים, למשל 'נתוני מפה: Google, ‏ Maxar Technologies'. כש-Google מספקת ייחוס לצד שלישי, ציון 'מפות Google' או שימוש בלוגו של Google בלבד לא נחשבים לייחוס נאות.

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

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

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

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

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

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

ייחוסים של צד שלישי

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

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

אם האפליקציה שלכם מציגה מידע שהתקבל באמצעות קריאה ל-Place Details עם מזהה מקום, האפליקציה צריכה להציג גם שיוכים לצד שלישי של פרטי המקום שהתקבלו.

השיוכים באובייקט Place של תגובה מיוצגים על ידי אובייקט Attribution. כדי להוסיף את Attribution לתשובה, צריך לכלול את places.attributions (חיפוש בקרבת מקום וחיפוש טקסט) או את attributions (פרטי מקום) בfield mask של הבקשה.

השדות של אובייקט Attribution הם מחרוזות שמכילות את provider ו-providerUri של השיוך, או מחרוזת ריקה אם אין שיוכים להצגה.

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

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

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

כל רכיב במערך photos הוא מופע של Photo, שמכיל את המערך authorAttributions, מסוג AuthorAttribution.

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

הצגת ביקורת

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

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

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

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

כל ביקורת באובייקט Place של תגובה מיוצגת על ידי אובייקט Review. כדי להוסיף את האובייקט Review לתגובה, צריך לכלול את places.reviews (חיפוש בקרבת מקום וחיפוש טקסט) או את reviews (פרטי מקום) במסכת השדות של הבקשה.

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

שיוך תוצאות החיפוש

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

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

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

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

Button 2: OK

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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