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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

הערכים של attributions מוצגים כאובייקט NSAttributedString.

אחזור שיוך לאוסף של מקומות

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

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

שיוך של תוצאות חיפוש

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

כותרת: מידע על התוצאות האלה

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

לחצן 1: מידע נוסף
הטקסט 'מידע נוסף' צריך לקשר למאמר במרכז העזרה.

לחצן 2: אישור

הצגת קרדיטים לתמונה

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

דוגמה לייחוס של צד שלישי

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

דפים עסקיים של Example Company

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

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

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

שטח פנוי

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

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

המרווח בין הלוגו של Google לבין הטקסט של השיוך

קריאות

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

צבע

שימוש בטקסט בצבע 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;