במסמך הזה מפורטות דרישות ספציפיות לכל האפליקציות שפותחו באמצעות 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 בפינה הימנית התחתונה של המפה, עם הייחוס מידע נוסף בפינה הימנית התחתונה, שניהם אמורים להיות מוצגים על המפה להיות מוצגים בכללותה ולא מתחת למפה או במקום אחר באפליקציה. בדוגמה הבאה אפשר לראות את הלוגו של Google בפינה הימנית התחתונה של המפה, ואת ייחוס בפינה הימנית התחתונה.
![מיקום השיוך (Attribution) במדיניות](https://developers.google.com/static/maps/images/policies_attribution_placement.png?hl=he)
לשימוש על רקע בהיר | לשימוש על רקע כהה |
---|---|
![]() |
![]() |
קובץ ה-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
לכל אחד
שבה הם מופיעים.
- כדי לגשת לשיוכים, משתמשים
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
ולהגדיר את 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.
![](https://developers.google.com/static/maps/images/policies_spacing.png?hl=he)
קריאות
הקרדיט תמיד צריך להיות ברור, קריא ולהופיע בווריאציות הצבע המתאימות עם רקע מסוים. חשוב תמיד ליצור ניגודיות מספקת בין הווריאציה של הלוגו בחירה.
צבע
שימוש בטקסט אפור 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;