מסמך זה מפרט את הדרישות הספציפיות לכל האפליקציות שפותחו באמצעות Places API, כולל שירות השלמה אוטומטית של מקומות שהוא חלק מאותו API. אפשר למצוא מידע כללי נוסף למפתחי מפות Google בתנאים ובהגבלות של הפלטפורמה של מפות Google.
הצגת התנאים וההגבלות ומדיניות הפרטיות
אם פיתחת אפליקציה של Places API, עליך לפרסם באפליקציה את התנאים וההגבלות ואת מדיניות הפרטיות, שעומדת בהנחיות המפורטות בהסכם שלך עם Google:
- התנאים וההגבלות ומדיניות הפרטיות צריכים להיות גלויים לכולם.
- עליך לציין במפורש בתנאים ובהגבלות של האפליקציה שהשימוש באפליקציה מחייב את המשתמשים לתנאים ולהגבלות של Google.
- עליך להודיע למשתמשים במדיניות הפרטיות שלך שהשתמשת ב-Google Maps API, ולהקפיד לכלול אותם במדיניות הפרטיות של Google.
המקום המומלץ שבו יופיעו התנאים וההגבלות ומדיניות הפרטיות שלך תלוי בפלטפורמה של האפליקציה.
אפליקציות לנייד
אם מפתחים אפליקציה לנייד, מומלץ לספק קישור לתנאים ולהגבלות ולמדיניות הפרטיות בדף ההורדה של האפליקציה, בחנות האפליקציות הרלוונטית ובתפריט ההגדרות של האפליקציה.
אפליקציות אינטרנט
כאשר מפתחים אפליקציית אינטרנט, מומלץ לספק קישור לתנאים ולהגבלות ולמדיניות הפרטיות בכותרת התחתונה של האתר.
אחזור מראש, שמירה במטמון או אחסון של תוכן
יישומים המשתמשים בממשק API של מקומות מחויבים לתנאים של ההסכם שלך עם Google. בכפוף לתנאי ההסכם, אסור לך לאחזר מראש, להוסיף לאינדקס, לאחסן או לשמור במטמון תוכן כלשהו, למעט בתנאים המוגבלים שמפורטים בתנאים.
שימו לב שמזהה המקום, שמשמש לזיהוי ייחודי של מקום, פטור מההגבלות על השמירה במטמון. מזהה המקום מוחזר בשדה 'place_id' בתגובות של Places API. במדריך למזהי מקומות מוסבר איך לשמור, לרענן ולנהל מזהי מקומות.
הצגת תוצאות של Places API
תוכל להציג תוצאות של Places API במפת Google, או ללא מפה. אם ברצונך להציג תוצאות של Places API במפה, יש להציג את התוצאות האלה במפת Google. אסור להשתמש בנתוני Places API במפה שאינה מפת Google.
הצגת הלוגו והמאפיינים של Google
אם האפליקציה שלך מציגה נתונים במפות Google, הלוגו של Google ייכלל ולא ניתן יהיה לשנות אותו. אפליקציות שמציגות נתוני Google באותו מסך שבו מוצגת מפת Google לא נדרשות לספק ייחוס נוסף ל-Google.
אם האפליקציה מציגה נתונים בדף או בתצוגה שלא כוללים גם מפת Google, עליך להציג לוגו של Google עם הנתונים האלה. לדוגמה, אם האפליקציה שלך מציגה נתוני Google בכרטיסייה אחת, ומפת Google עם הנתונים האלה בכרטיסייה אחרת, הכרטיסייה הראשונה חייבת להציג את הלוגו של Google. אם באפליקציה נעשה שימוש בשדות חיפוש עם או בלי השלמה אוטומטית, הלוגו חייב להיות מוצג בתוך השורה.
יש למקם את הלוגו של Google בפינה השמאלית התחתונה של המפה, ואת פרטי הייחוס בפינה השמאלית התחתונה. פרטי הייחוס צריכים להופיע במפה כולה, ולא מתחת למפה או במקום אחר באפליקציה. בדוגמה הבאה אפשר לראות את הלוגו של Google בפינה הימנית התחתונה של המפה, ואת השיוך בפינה הימנית התחתונה.
![מיקום של שיוך מדיניות](https://developers.google.cn/static/maps/images/policies_attribution_placement.png?authuser=9&hl=he)
לשימוש על רקע בהיר | לשימוש על רקע כהה |
---|---|
![]() |
![]() |
קובץ ה-ZIP הבא מכיל את הלוגו של Google בגדלים המתאימים לאפליקציות למחשב, ל-Android ול-iOS. אסור לשנות את הגודל של סמלי הלוגו האלה או לשנות אותם בשום צורה.
הורדה: google_logo.zip
אל תשנו את השיוך. אל תסירו, תסתירו או תחתוך את פרטי השיוך. לא ניתן להשתמש בסמלי לוגו של Google בתוך השורה (לדוגמה, "המפות האלה הן של [Google_logo]").
לשמור על שיוך קרוב. אם משתמשים בצילומי מסך של תמונות Google מחוץ להטמעות ישירות, צריך לכלול את השיוך הרגיל כפי שהוא מופיע בתמונה. במידת הצורך, אפשר להתאים אישית את הסגנון והמיקום של טקסט הייחוס, כל עוד הטקסט קרוב לתוכן וקריא לצופה או לקורא הממוצע. אסור להרחיק את הקרדיט מהתוכן, למשל לסוף הספר, לקרדיטים של הקבצים או לתוכנית או לכותרת התחתונה של האתר.
הכללת ספקי נתונים מצד שלישי חלק מהנתונים והתמונות במוצרי המיפוי שלנו מגיעים מספקים שהם לא Google. אם משתמשים בתמונות כאלה, הטקסט של השיוך צריך לכלול את השם "Google" ואת ספקי הנתונים הרלוונטיים, למשל "נתוני מפה: Google, Maxar Technologies". כאשר ספקי נתונים של צד שלישי מצוטטים יחד עם התמונות, הוספת המילה "Google" או הלוגו של Google אינה הולמת.
אם אתם משתמשים בפלטפורמה של מפות Google במכשיר שבו תצוגת השיוך (Attribution) לא מעשית, אפשר ליצור קשר עם צוות המכירות של Google כדי לדון ברישיונות שמתאימים לתרחיש לדוגמה שלכם.
דרישות אחרות לגבי שיוך (Attribution)
בצע את ההוראות הבאות כדי לאחזר ייחוסים של צד שלישי ולהציג את הייחוסים באפליקציה שלך.
אחזור ייחוסים ממקום מסוים
אם באפליקציה מוצג מידע שהתקבל מקריאה לפרטי מקום עם מזהה מקום, האפליקציה חייבת להציג גם שיוכים של צד שלישי לפרטי המקום שהתקבלו.
הייחוסים באובייקט Place
של תגובה מיוצגים על ידי אובייקט Attribution
. כדי להוסיף את Attribution
לתשובה, צריך לכלול את places.attributions
(חיפוש בקרבת מקום וחיפוש טקסט) או את attributions
(פרטי המקום) באנונימיזציה של השדות של הבקשה.
השדות של האובייקט Attribution
הם מחרוזות שמכילות את ה-provider
וה-providerUri
של השיוך, או מחרוזת ריקה אם אין
ייחוסים להצגה.
הצגת ייחוסים של תמונה
אם באפליקציה מוצגות תמונות, צריך להציג את הקרדיטים של המחבר לכל תמונה שבה הן מוצגות.
פרטים על התמונה באובייקט Place
של תגובה נכללים במערך photos
. כדי להוסיף את המערך photos
לתגובה, צריך לכלול את places.photos
(חיפוש בקרבת מקום וחיפוש טקסט) או את photos
(פרטי מקום) במסכת השדות של הבקשה.
כל רכיב במערך photos
הוא מופע של Photo
, שמכיל את המערך authorAttributions
מסוג AuthorAttribution
.
השדות של האובייקט AuthorAttribution
הם מחרוזות שמכילות את השדות displayName
, uri
ו-photoUri
של השיוך, או מחרוזת ריקה אם אין ייחוסים להצגה.
הצגת ביקורת
אובייקט Place
בתגובה יכול להכיל עד חמש ביקורות. תוכלו להציג את הביקורות האלה באפליקציה, באופן אופציונלי.
כשמציגים ביקורות שנכתבו על ידי משתמשי Google, צריך למקם את שם המחבר בסמוך. אם האפשרות זמינה בשדה Attribution של המחבר באובייקט Review
, מומלץ לכלול גם את התמונה של המחבר ולקשר לפרופיל שלו. התמונה הבאה מציגה דוגמה לביקורת על פארק:
![תצוגת ייחוס של מחבר](https://developers.google.cn/static/maps/documentation/places/images/review_attributions.png?authuser=9&hl=he)
Google ממליצה גם להציג את אופן המיון של הביקורות למשתמש הקצה.
כל ביקורת באובייקט Place
של תגובה מיוצגת על ידי אובייקט Review
. כדי להוסיף את האובייקט Review
לתגובה, כוללים את places.reviews
(חיפוש בקרבת מקום וחיפוש טקסט) או reviews
(Place Details) במסכה של השדה של הבקשה.
השדות של האובייקט Review
מכילים את השיוך, או שהם ריקים אם אין שיוך להצגה.
הנחיות בנושא סגנון לשיוך ב-Google
אם אין אפשרות להשתמש בלוגו של Google שניתן להוריד, ריכזנו כאן הנחיות בנושא סגנון של ייחוס Google ב-CSS וב-HTML.
שטח פנוי
השטח הפנוי מסביב לנעילה צריך להיות שווה לגובה האות G ב-Google או גדול ממנה.
הרווח בין עותק הייחוס לבין הלוגו של Google צריך להיות חצי מרוחב האות G.
![](https://developers.google.cn/static/maps/images/policies_spacing.png?authuser=9&hl=he)
קריאות
כותרת המשנה צריכה תמיד להיות ברורה וקריאה, ולהופיע בגרסת הצבע המתאימה לרקע מסוים. הקפידו תמיד ליצור ניגודיות מספקת בין הווריאציות של הלוגו שתבחרו.
צבע
רצוי להשתמש בטקסט Google Material Gray 700 על רקע לבן או בהיר עם טווח של 0% עד 40% בגוון שחור מקסימלי.
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
בתמונות עם רקע כהים ובדפוסים צילום או מצב 'לא פנוי', כדאי להשתמש בטקסט לבן כקרדיט ולייחוס.
#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;