המדיניות של Places SDK ל-Android

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

הצגת תנאי השימוש ומדיניות הפרטיות

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

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

המיקום המומלץ לפרסום התנאים וההגבלות ומדיניות הפרטיות תלוי בפלטפורמה של האפליקציה.

אפליקציות לנייד

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

אפליקציות אינטרנט

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

אחסון, אחזור מראש או שמירת תוכן במטמון

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

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

הצגת תוצאות של Places SDK ל-Android

אפשר להציג את התוצאות של Places SDK ל-Android במפה של Google או בלי מפה. אם רוצים להציג במפה תוצאות של Places SDK ל-Android, צריך להציג את התוצאות האלה במפה של Google. אסור להשתמש בנתונים של Places SDK ל-Android במפה שאינה מפות Google.

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

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

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

מיקום שיוך למדיניות

קובץ ה-zip הבא מכיל את הלוגו של Google בגדלים המתאימים לאפליקציות למחשב, ל-Android ול-iOS. אסור לשנות את הלוגואים האלה או לשנות את הגודל שלהם בשום צורה.

הורדה: google_logo.zip

לא משנים את השיוך. אסור להסיר, להסתיר או לחתוך את פרטי השיוך. אסור להשתמש בסמלי לוגו של Google בתוך שורות טקסט (לדוגמה, "המפות האלה מגיעות מ-[Google_logo]").

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

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

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

דרישות אחרות בנושא שיוך

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

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

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

כדי לגשת לביקורות, מקישים על 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, ולא לכל מקום.

אחת מהדרכים להציג את השיוך היא באמצעות 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>

הנחיות בנושא סגנון לשיוך (Attribution) ב-Google

בהמשך מפורטות הנחיות סגנון לשימוש בנכסי שיוך של Google ב-CSS וב-HTML, אם אין לכם אפשרות להשתמש בלוגו של Google שניתן להורדה.

שטח פנוי

רוחב השוליים מסביב ל-lockup צריך להיות שווה לגובה האות 'G' ב-Google, או גדול ממנו.

הרווחים בין תוכן השיוך לבין הלוגו של Google צריכים להיות חצי מהרוחב של האות 'G'.

קריאות

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

צבע

שימוש בטקסט בצבע Google Material Gray 700 על רקע לבן או בהיר עם גוון שחור מקסימלי של 0% עד 40%.

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

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

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

גופן

משתמשים בגופן Roboto.

דוגמה ל-CSS

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

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;