מדיניות וייחוסים ל-Geocoding API

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

מדיניות

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

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

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

סינון ושינוי סדר בצד הלקוח

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

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

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

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

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

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

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

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

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

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

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

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

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

שיוך הלוגו

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

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

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

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

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

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

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

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

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

הלוגו של מפות Google עם השטח הפנוי המינימלי וטווח הגדלים הקביל
דוגמה ללוגו של מפות Google עם השטח הפנוי המינימלי וטווח הגדלים המקובל

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

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

שיוך טקסט

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

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

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

התמונות הבאות מציגות דוגמאות לדרישות החזותיות האלה.

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

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

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

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

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

סיכומים מבוססי-AI (יעדים)

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

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

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

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

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

דרישות בנוגע לסיכום ההגעה

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

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

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

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

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

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

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

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

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