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

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

מדיניות

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

נגישות הלוגו

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

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

דוגמאות לשינויים לא מקובלים ולבעיות נגישות בשיוך של סמל הלוגו של מפות Google

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

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

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

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

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

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

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

אסור להסתיר את ציון המקור של מפות 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, יכול להכיל אחד משני סוגי שיוך:

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

Button 2: OK

הצגת ביקורת

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

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