במסמך הזה מפורטות הדרישות הספציפיות לכל האפליקציות שפותחו באמצעות Places API (חדש), כולל שירות ההשלמה האוטומטית (חדש) שהוא חלק מה-API הזה. מידע כללי נוסף למפתחים של מפות Google זמין בתנאים ובהגבלות של הפלטפורמה של מפות Google.
מדיניות
בקטע הזה מתוארים כללי המדיניות שרלוונטיים ל-Places API. המדיניות מספקת הנחיות ודרישות מעשיות להטמעה, כדי לעזור לכם להשתמש בשירות בצורה נכונה ובהתאם לציפיות של Google Maps Platform.
חריגים להגבלות על שמירה במטמון
שימו לב: מזהה המקום, שמשמש לזיהוי ייחודי של מקום, פטור מהגבלות השמירה במטמון.
לכן, אתם יכולים לאחסן ערכים של מזהי מקומות ללא הגבלת זמן.
מזהה המקום מוחזר בשדה place_id בתגובות מה-API. במדריך בנושא מזהי מקומות מוסבר איך לשמור, לרענן ולנהל מזהי מקומות.
מדינות וטריטוריות באזור הכלכלי האירופי (EEA)
למוצר הזה יש תנאים והגבלות שונים ללקוחות עם כתובת לחיוב באזור הכלכלי האירופי (EEA), ויכול להיות שגם הפונקציונליות שלו שונה. לפני שמתחילים לפתח באמצעות הפלטפורמה של מפות Google, חשוב לקרוא את התנאים והמידע הבאים שרלוונטיים ל-EEA:
- התנאים וההגבלות של הפלטפורמה של מפות Google באזור הכלכלי האירופי
- התנאים הספציפיים לשירות של הפלטפורמה של מפות Google באזור הכלכלי האירופי
- שאלות נפוצות בנושא EEA
- הדרישות של Google Maps Platform בנושא בטיחות בדרכים
אם הכתובת שלכם לחיוב לא נמצאת ב-EEA, התנאים וההגבלות הבאים חלים עליכם:
דרישות הייחוס של מפות Google
בקטע הזה מפורטות הדרישות וההנחיות בנושא ייחוס להצגת מפות Google ותוכן דרך האפליקציות שלכם.
הצגת השיוך (Attribution) של מפות Google
כשמציגים תוכן מממשקי ה-API של Google Maps Platform באפליקציה או באתר, צריך לפעול בהתאם לדרישות הייחוס של מפות Google. אין צורך להוסיף שיוך נוסף אם התוכן מוצג במפות Google והשיוך כבר גלוי.
הוספת שיוך למפות Google
לגבי שיוך למפות Google שכבר סופק על ידי Google Maps Platform בממשק המשתמש, כמו ב-Places UI Kit:
- אין להסיר את השיוך (Attribution) הכלול, לא משנה איפה הוא מוצג. אסור לשנות, להסתיר או לטשטש את השיוך, וצריך לוודא שהוא מוצג בבירור על הרקע.
- תמיד צריך להבחין באופן חזותי בין תוכן של Google Maps Platform לבין תוכן אחר באמצעות רמזים בממשק המשתמש, כמו גבול, צבע רקע, צל או מספיק שטח לבן.
- כשמבצעים שינויים חזותיים, צריך לעמוד בכל דרישות הייחוס של מפות Google.
הלוגו של מפות Google ושיוך (Attribution) טקסט
השיוך צריך להיות בצורת הלוגו של מפות Google, ככל האפשר. במקרים שבהם המקום מוגבל, אפשר להשתמש בטקסט מפות Google. למשתמשי הקצה תמיד צריך להיות ברור איזה תוכן מסופק על ידי מפות Google.
שיוך הלוגו
כדי להשתמש בלוגו של מפות Google באפליקציה או באתר, צריך לפעול לפי הדרישות הבאות.הורדת סמלי הלוגו של מפות Google
השתמשו בקובצי הלוגו הרשמיים של מפות Google. אתם יכולים להוריד את סמלי הלוגו שבהמשך ולפעול לפי ההנחיות שבקטע הזה.
הורדת נכסי השיוך של מפות Googleכשמשתמשים בלוגו של מפות Google, צריך לפעול לפי ההנחיות הבאות.
- אסור לשנות את הלוגו בשום צורה.
- כדי למנוע עיוות, חשוב לשמור על יחס הגובה-רוחב של הלוגו.
- השתמשו בלוגו עם קווי המתאר על רקע עמוס, כמו מפה או תמונה.
- השתמשו בלוגו ללא קווי מתאר על רקע פשוט, כמו צבע אחיד או מעבר צבעים עדין.
מפרט הגודל של הלוגו
הלוגו של מפות Google צריך לעמוד במפרט הגודל הבא:- גובה מינימלי של הלוגו: 16dp
- גובה מקסימלי של הלוגו: 19dp
- שטח פנוי מינימלי מסביב ללוגו: 10dp משמאל, מימין ומלמעלה, 5dp מלמטה
למידע נוסף על dp, אפשר לעיין בקטע צפיפות פיקסלים באתר Material Design.
נגישות של הלוגו
כדי לעמוד בדרישות הנגישות, צריך להשתמש בלוגו של מפות Google באופן הבא:- חשוב לשמור על ניגודיות נגישה בין הלוגו לרקע.
- מוסיפים תווית נגישות עם הטקסט מפות Google.
שיוך טקסט
אם גודל הממשק לא מאפשר להשתמש בלוגו של מפות Google, אפשר לכתוב מפות Google בטקסט. בצע את ההנחיות הבאות:
- אל תשנו את הטקסט מפות Google בשום צורה:
- אל תשנו את האותיות הרישיות ב-Google Maps
- אל תעבירו את מפות Google לשורות נפרדות
- אל תתרגמו את מפות Google לשפה אחרת.
- כדי למנוע מדפדפנים לתרגם את מפות Google, משתמשים במאפיין ה-HTML
translate="no".
כדי לעצב את הטקסט במפות Google, צריך לפעול לפי ההוראות בטבלה הבאה:
הדרישות של מפות Google בנוגע לסגנון הטקסט נכס סגנון משפחת גופנים Roboto. לא חובה לטעון את הגופן. משפחת גופנים חלופית כל גופן Sans Serif לגוף הטקסט שכבר נמצא בשימוש במוצר, או "Sans-Serif" כדי להפעיל את גופן ברירת המחדל של המערכת סגנון הגופן רגיל עובי הגופן 400 צבע גופן לבן, שחור (#1F1F1F) או אפור (#5E5E5E). שמרו על ניגודיות נגישה (4.5:1) ביחס לרקע. גודל גופן גודל גופן מינימלי: 12sp
גודל גופן מקסימלי: 16sp
מידע ולמידה על sp זמין בקטע יחידות של גודל גופן באתר Material Design.ריווח בין אותיות רגיל
דוגמה ל-CSS
ה-CSS הבא מציג את מפות Google עם הסגנון הטיפוגרפי והצבע המתאימים על רקע לבן או בהיר.
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap'); .GMP-attribution { font-family: Roboto, Sans-Serif; font-style: normal; font-weight: 400; font-size: 1rem; letter-spacing: normal; white-space: nowrap; color: #5e5e5e; }
דרישות בנושא רכיבים חזותיים
כדי להציג את השיוך למפות Google, צריך לפעול לפי הדרישות הבאות.הציבו את השיוך קרוב לחלק העליון או התחתון של התוכן, ובתוך אותו מאגר חזותי. אם התוכן הוא בשורה אחת, אפשר למקם את השיוך מימין או משמאל.
כדי להבדיל באופן חזותי בין תוכן של הפלטפורמה של מפות Google לבין תוכן אחר, צריך להשתמש ברמזים בממשק המשתמש, כמו גבול, צבע רקע, צל או מספיק שטח לבן.
- אסור להציג מצג שווא לגבי מפות Google על ידי שיוך של תוכן שלא שייך ל-Google Maps Platform.
- מוודאים שהשיוך תמיד גלוי וקריא. אסור להסיר, להסתיר, לטשטש או לשנות אותו.
התמונות הבאות מציגות דוגמאות לדרישות החזותיות האלה.
ספקי נתונים של צד שלישי
חלק מהנתונים והתמונות במוצרי המפות שלנו מגיעים מספקים שאינם Google. במוצרים מסוימים, כמו Map Tiles API, יכול להיות שנספק לכם את השיוך הנדרש לספק הנתונים של הצד השלישי. במקרים כאלה, הטקסט של השיוך חייב לכלול את השם "מפות Google" ואת ספקי הנתונים הרלוונטיים, למשל "נתוני מפה: Google, Maxar Technologies". כש-Google מספקת ייחוס לצד שלישי, הוספה של "מפות Google" או של הלוגו של Google בלבד לא נחשבת לייחוס תקין.
דרישות נוספות של Places API
הדרישות הבאות הן ספציפיות ל-Places API.
השלמה אוטומטית של כתובות של משתמשי קצה
כשמשתמש קצה משתמש בפונקציונליות של השלמה אוטומטית באפליקציית הלקוח כדי להקליד כתובת רחוב, והכתובת הזו הייתה מסופקת באופן מלא ומדויק על ידי משתמש הקצה גם בלי השלמה אוטומטית, הכתובת שנבחרה על ידי משתמש הקצה לא כפופה להגבלות התוכן של מפות Google בהסכם שלך עם Google Maps Platform. החריג הזה חל רק על כתובת הרחוב שנבחרה על ידי משתמש הקצה ורק על העסקה הספציפית של אותו משתמש קצה. הוא לא חל על רשימת הכתובות המוצעות שמופיעות בפונקציונליות של ההשלמה האוטומטית או על תוכן אחר של מפות Google. החריג הזה לא חל על פונקציונליות של חיפוש נקודות עניין או כתובות שמוצעת על ידי שירותים אחרים של Google Maps Platform.
רשימת הכתובות שמימין עדיין כפופה להגבלות על התוכן במפות Google. אחרי שמשתמש הקצה בוחר את הכתובת הרצויה, הכתובת הזו לא כפופה להגבלות על תוכן של מפות Google, אך ורק למטרת העסקה הרלוונטית של אותו משתמש קצה.
תמונות וסקירות
לשייך את כל התוכן ליוצר התוכן
כשמציגים תמונות או ביקורות, חובה תמיד לתת קרדיט ליוצר. כל תמונה וביקורת כוללות שיוך למחבר (תמונת הדמות, השם והקישור לפרופיל של המחבר).
דרישות חזותיות לשיוך למחבר:
- אם יש מספיק מקום, צריך לציין את המחבר באמצעות כל המשאבים הזמינים (תמונת פרופיל, שם וקישור לפרופיל).
- בביקורות, אם המקום מוגבל, הדרישה המינימלית היא להציג את הדמות של המחבר.
- בתמונות, אם המקום מוגבל (למשל בגלריה או בתמונות ממוזערות), אפשר להשמיט את שיוך המחבר, בתנאי שהמשתמש יכול לגשת לגרסה גדולה יותר של התמונה שכוללת את שיוך המחבר המלא.
- הציבו את שיוך המחבר כך שיהיה קשור באופן ברור לתמונה או לביקורת של המחבר.
לספק גישה ישירה לתוכן המקור במפות Google
לגבי כל תמונה וביקורת, למשתמשי הקצה תמיד צריכה להיות גישה לצפייה בתמונה או בביקורת המקורית במפות Google באמצעות ה-googleMapsUri שסופק.
הצגת תאריך הפרסום היחסי (מומלץ) *
הצגת תאריך הפרסום היחסי (לדוגמה, "לפני יומיים") של תמונות וביקורות באמצעות relativePublishTimeDescription שסופק מגבירה את אמון המשתמשים בתוכן.
הפעלת דיווח על תוכן (מומלץ) *
תמונות וביקורות שסופקו דרך Places API (החדש) ו-Places API (הדור הקודם) כפופות למדיניות התוכן והמוצרים של Google בכל מקום בעולם. אתם ומשתמשי הקצה שלכם יכולים לדווח על תוכן שאתם רוצים להסיר משירותי Google בכפוף למדיניות של Google או לדינים החלים, באמצעות flagContentUri לכל תמונה וביקורת. אפשר גם לדווח על תוכן באמצעות הקישור הישיר לתוכן במפות Google, שבו אפשר גם לדווח על בעיה.
ביקורות
תיאור של אופן הסידור והסינון של הביקורות
לכלול הודעה ברורה שמתארת איך הביקורות מסודרות ומסוננות, כולל קריטריונים לחיפוש שהופעלו. כברירת מחדל, הביקורות מסודרות לפי מידת הרלוונטיות שלהן.
הצגת החודש והשנה שבהם כותבי הביקורות ביקרו במקומות בצרפת
כשמציגים ביקורות על מקומות בצרפת ובטריטוריות צרפתיות, Places API מחזיר את השדה
visitDate (החודש והשנה שבהם כותב הביקורת ביקר במקום), שצריך להציג לצד התוכן.
הודעה למשתמשי הקצה כשהביקורות תורגמו (מומלץ) *
ליידע את משתמשי הקצה כשביקורת תורגמה משפת המקור שלה. אתם יכולים לאפשר למשתמשי הקצה לראות את הטקסט המקורי שלא תורגם originalText. לחלופין, הם יכולים ללחוץ על הקישור הישיר לתוכן במפות Google, שבו זמין הטקסט המקורי שלא תורגם.
ביקורות ודירוג ממוצע
ליידע את משתמשי הקצה איך Google מאמתת ביקורות (מומלץ) *
Google לא מאמתת את הביקורות, אבל היא בודקת אותן ומסירה תוכן שמזוהה כמזויף. כשמציגים ביקורות ודירוג ממוצע, צריך ליידע את משתמשי הקצה לגבי מדיניות הביקורות של Google. מידע נוסף על המדיניות של מפות Google בנושא תוכן שנוצר על ידי משתמשים
סיכומים מבוססי-AI
כשמציגים באפליקציה סיכומים מבוססי-AI, כולל סיכומים של מקומות, אזורים וביקורות, צריך:
- להציג את השיוכים (Attribution), הקישורים לדיווח והקישורים להפניה הנדרשים, כפי שמוגדר בהמשך.
- משתמשי הקצה צריכים להיות מסוגלים לקרוא את הטקסט המלא של הסיכום כפי שהוא מסופק על ידי מפות Google.
הצגת טקסט הגילוי הנאות לגבי סיכומים מבוססי-AI
כשמציגים סיכום מכל סוג שמבוסס-AI, תמיד צריך לכלול את טקסט הגילוי הנאות המותאם לשוק המקומי (שמצוין בשדה disclosureText בגוף התשובה) מיד מתחת לסיכום. אסור לשנות או להוסיף לטקסט הגילוי הנאות שסופק על ידי ה-API.
דרישות נוספות לגבי סיכומי מקומות ואזורים
תקצירי מקומות ותקצירי אזורים שמוצגים באפליקציה חייבים לכלול את הטקסט והקישורים הבאים:
| טקסט | דרישה |
|---|---|
| מידע על הסיכום הזה | הקישור הבא מוביל למאמר "מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות": https://support.google.com/local-listings/answer/9851099. |
| סיכום הדוח |
כדי לדווח ל-Google על בעיה בתוכן של סיכום, משתמשים בקישור שמופיע בשדה הערה: סיכומים מבוססי-AI שנוצרים באמצעות Places API (החדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. עליך להודיע למשתמשי הקצה שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL שסופקה לדיווח על תוכן ( |
הדרישות לגבי סיכום של ביקורות
סיכום של ביקורות שמוצגים באפליקציה חייבים לכלול כותרת עם הטקסט "סיכום של ביקורות". בנוסף, צריך להשתמש בטקסט ובקישורים הנדרשים הבאים:
| טקסט | דרישה |
|---|---|
| מידע על הסיכום הזה | הקישור הבא מוביל למאמר "מהם מקורות המידע של Google ואיך היא משתמשת במידע הזה בדפי פרטים של מקומות": https://support.google.com/local-listings/answer/9851099 |
| סיכום הדוח |
משתמשים בקישור שמופיע בשדה הערה: סיכומים מבוססי-AI שנוצרים באמצעות Places API (החדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. עליך להודיע למשתמשי הקצה שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, הם צריכים לדווח עליו באמצעות כתובת ה-URL שסופקה לדיווח על תוכן ( |
| לצפייה בביקורות | משתמשים בקישור שמופיע בשדה reviewSummary.reviewsUri בתגובה. |
הצגת הנחיות לתרחישי שימוש בתחום הרכב
כדי לשמור על בטיחות הנהג, Google ממליצה להציג סיכומים מבוססי-AI במצב חנייה בחוויית השימוש ברכב. אם אתם מציגים סיכומים במצב נהיגה, המידע במסך צריך להיות ברור ותמציתי כדי שהנהג יוכל לחזור במהירות להתרכז בכביש:
- עד 3 שורות
- עד 120 תווים או 24 מילים
- גודל גופן מינימלי של 24dp
במיוחד בהקשרים של כלי רכב, המפתח אחראי להציג סיכומים מבוססי-AI בדרכים בטוחות ותואמות לכל החוקים והתקנות המקומיים.
תוצאות חיפוש מקומות
תארו את הגורמים שמשפיעים על דירוג תוצאות החיפוש (מומלץ) *
באינטראקציה אחת עם המשתמש, משתמשי הקצה צריכים להיות מודעים לגורמים העיקריים ולמשקל של הגורמים העיקריים שקובעים את הדירוג של תוצאות החיפוש.
כשמשתמשים בדירוג של Google בלי שינויים, אפשר להציג את ההסבר הבא:
"כשמחפשים במפות Google עסקים או מקומות ליד מיקום מסוים, מוצגות תוצאות מהסביבה הקרובה. כדי להציג את התוצאות שהכי מתאימות לשאילתת החיפוש, המערכת משתמשת בשילוב של כמה גורמים – בעיקר רלוונטיות, מרחק וחשיבות. מידע נוסף"
תאימות לדין החל
אתם נדרשים לפעול בהתאם לכל החוקים הרלוונטיים בכל שלב. שימו לב ששיטות עבודה שמסומנות כ(מומלצות) במדיניות הזו עדיין עשויות להיות מחייבות על פי חוק. בנוסף, גם אם תפעלו לפי כל הדרישות והשיטות המומלצות שצוינו, זה לא מבטיח עמידה מלאה בהוראות הדין בכל תחומי השיפוט. אם יש לכם שאלות לגבי סטטוס התאימות שלכם, כדאי לפנות לייעוץ משפטי.