מדיניות וייחוסים שרלוונטיים ל-Places SDK ל-Android

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

מדיניות

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

אחסון נתונים, שמירה במטמון וגירוד נתונים (scraping)

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

• הגבלות על שמירה במטמון ועל גירוד נתונים (סעיפים 3.2.3(א) ו-(ב)): מותר לשמור במטמון או לאחסן תוכן של מפות Google רק כפי שמותר במפורש בתנאים הספציפיים לשירות של Google Maps Platform. אסור לייצא, לחלץ או לגרד תוכן ממפות Google לשימוש מחוץ לשירותים. לדוגמה, אסור לאחזר מראש, להוסיף לאינדקס, לאחסן או להפיץ מחדש תוכן של מפות Google מחוץ לשירותים, להוריד בכמות גדולה משבצות מפה, תמונות Street View, קואורדינטות, מסלולים, תוצאות של מטריצת מרחקים, מידע על כבישים, מידע על מקומות, ערכי גובה או פרטים של אזורי זמן, או להעתיק ולשמור שמות של עסקים, כתובות או ביקורות של משתמשים.
• הגבלות תוכן נגזר (סעיף 3.2.3(c)): השתמש בתוכן של מפות Google בתוך האפליקציה שלך כפי שמותר על פי תנאי השירות של Google Maps Platform. אל תיצרו תוכן שמבוסס על תוכן ממפות Google. לדוגמה, אסור לעקוב אחרי מאפיינים מצילומי לוויין או להמיר אותם לפורמט דיגיטלי, לבנות מודלים תלת-ממדיים או מודלים של פני שטח, להשתמש בערכי קווי הרוחב והאורך של מקומות כקלט לניתוח נקודה-בפוליגון, לבנות אינדקס מיקומים מתמונות Street View או להמיר זמני נסיעה מבוססי-טקסט לדיבור מסונתז.

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

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

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

בתנאים הספציפיים לשירות של Google Maps Platform מפורטים החריגים הבאים שבהם מותר לשמור נתונים במטמון:

• מזהי מקומות: מזהה המקום, שמשמש לזיהוי ייחודי של מקום, פטור מהגבלות השמירה במטמון. לכן, אתם יכולים לאחסן ערכים של מזהי מקומות ללא הגבלת זמן. מזהי המקומות מוחזרים בשדה id או בשדה place_id בתגובות מה-API. במדריך למזהי מקומות מוסבר איך לשמור, לרענן ולנהל מזהי מקומות.
• קואורדינטות של קו רוחב וקו אורך: אתם יכולים לשמור באופן זמני במטמון ערכים של קו רוחב (latitude) וקו אורך (longitude) למשך עד 30 ימים קלנדריים רצופים. לאחר מכן, אתם צריכים למחוק את הקואורדינטות שנשמרו במטמון, כשאתם משתמשים בשירותים שמעניקים את החריגה הזו בתנאים הספציפיים לשירות של Google Maps Platform:
  • ‫Routes API,‏ Route Optimization API,‏ Directions API (דור קודם) ו-Roads API
  • ‫Geocoding API,‏ Geolocation API ו-Address Validation API
  • ‫Places API,‏ Places UI Kit ו-Navigation SDK
• תקופות שמירה במטמון ספציפיות לשירות: בתנאים הספציפיים לשירות של Google Maps Platform מוגדרות גם תקופות שמירה במטמון ספציפיות לשדות ומטרות מותרות ל-Address Validation API, ל-Air Quality API, ל-Pollen API, ל-Solar API, ל-Weather API ול-Places Aggregate API.

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

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

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

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

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

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

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

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

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

בהמשך מוצגת דוגמה לשיוך (Attribution) ב-Places UI Kit.

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

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

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

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

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

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

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

במידת האפשר, השיוך צריך להיות בצורת הלוגו של מפות 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 Maps.
  • אל תעבירו את מפות Google לשורות מרובות
  • אל תתרגמו את מפות Google לשפה אחרת.
  • כדי למנוע מדפדפנים לתרגם את מפות Google, משתמשים במאפיין ה-HTML‏ translate="no".

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

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

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

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

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

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

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

דרישות אחרות בנוגע לייחוס

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

הערה: ביקורות ותמונות שסופקו דרך Places SDK ל-Android כפופות למדיניות התוכן והמוצרים של Google בכל מקום בעולם. כדי לדווח על תוכן שאתם או המשתמשים שלכם רוצים להסיר מהשירותים של Google בכפוף למדיניות Google או לדינים החלים, קראו את המאמר דיווח על תוכן ב-Google.

אחזור של פרטי ייחוס ממקום

אם האפליקציה מציגה מידע שהתקבל באמצעות קריאה ל-get place by ID, היא חייבת להציג גם את השיוך לצד שלישי של פרטי המקום שהתקבלו.

ה-API מחזיר אובייקט Place. כדי לאחזר שיוכים מהאובייקט Place, מפעילים את Place.getAttributions(). השיטה מחזירה List של אובייקטים מסוג String, או null אם אין שיוכים להצגה.

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.DISPLAY_NAME);
FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
  Place place = response.getPlace();
  textView.append("Place found: " + place.getName());
  List<String> attributions = place.getAttributions();
  if (attributions != null) {
    StringBuilder stringBuilder = new StringBuilder("Attributions: ");
    for (String attribution : attributions) {
      stringBuilder.append(attribution).append("\n");
    }
    textView.append(stringBuilder.toString());
  }}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
      // Handle the error.
    }
  }
);

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

אם באפליקציה שלכם מוצגות תמונות של מקומות, אתם צריכים להציג את השיוך של כל תמונה שיש לה שיוך. ‫PhotoMetadata, יכול להכיל אחד משני סוגים של שיוכים:

• שיוכים, מחרוזת שיוך שאפשר לגשת אליה באמצעות PhotoMetadata.getAttributions().
• ‫AuthorAttributions, אובייקט AuthorAttributions שאפשר לגשת אליו באמצעות PhotoMetadata.getAuthorAttributions().

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

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

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

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the author attributions object.
AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();
List<AuthorAttribution> authorAttributionList = authorAttributions.asList();

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

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

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

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

כפתור 1: מידע נוסף
הטקסט "מידע נוסף" צריך לקשר למאמר במרכז העזרה.

כפתור 2: אישור

הצגת ביקורת

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

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

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

הערה: כברירת מחדל, הביקורות ממוינות לפי רלוונטיות. ב-SDK החדש, מיון לפי רלוונטיות הוא האפשרות היחידה.

כדי לגשת לביקורות, מתקשרים אל Place.getReviews():

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    List<Review> reviews = place.getReviews();
    // For loop for iterating over the List
    for (int i = 0; i < reviews.size(); i++) {
      // For each review, get the Review object.
        Review placeReview = reviews.get(i);

      // Get any attribution and author attribution.
        String reviewAttribution = placeReview.getAttribution();
        AuthorAttribution authorAttribution = placeReview.getAuthorAttribution();

        // Display the review contents and attributions as necessary.
    }
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        // Handle the error.
    }
});

הצגת שיוכים של צד שלישי

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

ה-API יוצר שיוכים לכל המקומות שבהם האפליקציה משתמשת. השיוכים מסופקים לכל קריאה ל-API, ולא לכל מקום.

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

אחת הדרכים להציג את השיוכים היא באמצעות TextView. לדוגמה:

TextView attributionsText = (TextView) findViewById(R.id.attributions);
String thirdPartyAttributions = place.getAttributions();
attributionsText.setText(thirdPartyAttributions);

דוגמה לשיוך לצד שלישי

Listings by <a href="https://www.example.com/">Example Company</a>

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

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

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