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

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

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

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

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

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

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

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

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

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

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

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

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

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

ניתן להציג תוצאות של Places SDK ל-iOS במפות Google או בלי מפה. אם רוצים הצגת תוצאות של Places SDK ל-iOS במפה, ואז התוצאות האלה חייבות להיות מוצגות במפה של Google. אסור להשתמש ב-Place SDK לנתונים של iOS במפה שאינה מפת Google.

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

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

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

מיקום השיוך (Attribution) במדיניות

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

הורדה: google_logo.zip

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

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

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

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

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

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

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

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

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

כשמאחזרים מקום על ידי קבלת מקום לפי מזהה, הוא יכול לאחזר את הקרדיטים של המקום הזה נכס attributions פועל GMSPlace

הקבצים של attributions מסופקים בתור אובייקט NSAttributedString.

אחזור פרטי שיוך (Attribution) של אוסף מקומות

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

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

הצגת פרטי הייחוס של תמונה

אם האפליקציה מוצגת photos, צריך הצגת attributions ו-authorAttributions לכל אחד שבה הם מופיעים.

Swift

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}

Objective-C

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];

הצגת ביקורת

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

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

תצוגת פרטי המחבר/ת

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

כדי לגשת לביקורות:

Swift

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

Objective-C

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

ייחוס של צדדים שלישיים ברשת המדיה

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

השיטה המומלצת להציג את הייחוסים היא באמצעות UITextView, כי הקישורים בשיוך (Attribution) חייבים לפעול. כדי להבטיח שהקישורים יפעלו, צריך לתת למשתמש גישה ב-UITextView ולהגדיר את shouldInteractWithURL של UITextViewDelegate כדי להחזיר YES.

Swift

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}

Objective-C

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}

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

מודל שיוך לצד שלישי בדרך כלל מורכב מטקסט עם קישור. עבור דוגמה:

כרטיסי מוצר לפי חברה לדוגמה

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

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

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

שטח פנוי

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

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

קריאות

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

צבע

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

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

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

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;