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

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

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

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

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

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

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

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

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

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

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

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

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

לשימוש על רקע בהיר	לשימוש על רקע כהה

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

הורדה: google_logo.zip

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

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

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

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

דרישות נוספות לגבי שיוך (Attribution)

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

אחזור שיוכים של מקום

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

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

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 יכול להכיל אחד משני סוגים של פרטי ייחוס:

• Attribution – מחרוזת שיוך (Attribution) שניגשת אליה PhotoMetadata.getAttributions().
• AuthorAttributions – AuthorAttributions הגישה לאובייקט בוצעה על ידי PhotoMetadata.getAuthorAttributions().

כדי לקבל את פרטי הייחוס של המחרוזות לתמונה, צריך להתקשר PhotoMetadata.getAttributions() ה-method מחזירה רצף תווים ב-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() ה-method מחזירה אובייקט 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, צריך להציב את שמו של המחבר בקרבת מקום. כשהאפשרות זמינה בשדה הייחוס של המחבר של האובייקט 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) לכל המקומות שהאפליקציה משתמשת בהם. השיוךים מסופקים לכל קריאה ל-API, ולא לכל מקום.

אחת הדרכים להציג את הייחוסים היא TextView לדוגמה:

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

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

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

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

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

שטח פנוי

כמות השטח הפנוי מסביב ללוגו צריך להיות שווה לגובה או גדול ממנו של האות G ב-Google.

הרווח בין עותק הייחוס לבין הלוגו של Google צריך להיות חצי מהרוחב של את G.

קריאות

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

צבע

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

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

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

#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;