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

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

הצגת התנאים וההגבלות ומדיניות הפרטיות

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

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

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

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

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

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

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

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

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

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

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

דרישות אחרות לגבי שיוך (Attribution)

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

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

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

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

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.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();

הצגת ביקורת

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

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

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

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

שטח פנוי

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

כשמחילים את שירות ה-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;