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

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

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

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

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

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

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

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

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

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

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

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

שימו לב שמזהה המקום, שמשמש לזיהוי ייחודי של מקום, פטור מההגבלות על שמירה במטמון. מזהה המקום מוחזר בשדה 'place_id' ב-Place 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

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

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

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

  • כדי לגשת לשיוכים, צריך להשתמש GMSPlacePhotoMetadata.attributions. הנכס הזה הוא NSAttributedString או nil אם אין שיוכים שאפשר להציג.
  • כדי לגשת לייחוס של מחברים, משתמשים GMSPlacePhotoMetadata.authorAttributions. המאפיין הזה מכיל מערך של GMSPlaceAuthorAttribution אובייקטים.

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 ולהגדיר את ה-method של 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) של צד שלישי

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

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

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

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

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

שטח פנוי

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

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

קריאות

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

צבע

משתמשים בטקסט בצבע Google Material אפור 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;