במסמך הזה מפורטות הדרישות שספציפיות לכל האפליקציות שפותחו באמצעות Places API (חדש), כולל שירות ה-Autocomplete (חדש) שמהווה חלק מממשק ה-API הזה. מידע כללי נוסף למפתחים של מפות Google זמין בתנאים ובהגבלות של Google Maps Platform.
מדיניות
בקטע הזה מתוארת מדיניות שרלוונטית ל-Places API. המדיניות מספקת הנחיות ודרישות מעשיות להטמעה, כדי לעזור לכם להשתמש בשירות בצורה נכונה ובהתאם לציפיות של Google Maps Platform.
חריגים להגבלות על שמירת נתונים במטמון
שימו לב שמזהה המקום, שמשמש לזיהוי ייחודי של מקום, לא כפוף להגבלות על שמירת נתונים במטמון.
לכן, אפשר לאחסן ערכים של מזהי מקומות ללא הגבלת זמן.
מזהה המקום מוחזר בשדה place_id בתשובות של ה-API. במדריך למזהי מקומות מוסבר איך לשמור, לרענן ולנהל מזהי מקומות.
מדינות וטריטוריות באזור הכלכלי האירופי
למוצר הזה יש תנאים והגבלות שונים ללקוחות עם כתובת לחיוב באזור הכלכלי האירופי (EEA), ויכול להיות שגם הפונקציונליות שלו שונה. לפני שמתחילים לפתח באמצעות Google Maps Platform, חשוב לעיין בתנאים ובמידע הבאים שספציפיים לאזור הכלכלי האירופי:
- התנאים וההגבלות של Google Maps Platform באזור הכלכלי האירופי
- התנאים הספציפיים לשירות Google Maps Platform באזור הכלכלי האירופי
- שאלות נפוצות בנושא האזור הכלכלי האירופי (EEA)
- הדרישות של Google Maps Platform בנושא בטיחות בדרכים
אם הכתובת שלכם לחיוב לא נמצאת באזור הכלכלי האירופי, התנאים וההגבלות הבאים חלים עליכם:
דרישות השיוך של מפות Google
בקטע הזה מפורטות הדרישות וההנחיות בנושא שיוך (Attribution) להצגת מפות Google ותוכן דרך האפליקציות שלכם.
הצגת שיוך למפות Google
כשמציגים תוכן מ-Google Maps Platform APIs באפליקציה או באתר, צריך לפעול בהתאם לדרישות בנושא שיוך של מפות Google. אין צורך להוסיף שיוך אם התוכן מוצג במפת Google שבה השיוך כבר גלוי.
שיוך למפות Google
לגבי ייחוס של מפות Google שכבר מסופק על ידי Google Maps Platform בממשק המשתמש, כמו ב-Places UI Kit:
- אל תסירו את הקרדיט שניתן ליוצרים, לא משנה איפה הוא מוצג. אסור לשנות, להסתיר או לטשטש את השיוך, וצריך לוודא שהוא בולט על הרקע.
- חשוב תמיד להבחין חזותית בין תוכן של Google Maps Platform לבין תוכן אחר באמצעות רמזים בממשק המשתמש, כמו גבול, צבע רקע, צל או רווח לבן מספיק.
- כשמבצעים שינויים חזותיים, צריך לפעול בהתאם לכל הדרישות של Google Maps בנושא שיוך (attribution).
הלוגו של מפות Google ושיוך טקסטואלי
כשזה אפשרי, צריך להשתמש בלוגו של מפות Google כהפניה למקור. במקרים שבהם המקום מוגבל, אפשר להשתמש בטקסט מפות Google. חובה שלמשתמשי הקצה יהיה ברור איזה תוכן מסופק על ידי מפות Google.
שיוך ללוגו
צריך לפעול בהתאם לדרישות האלה כדי להשתמש בלוגו של מפות Google באפליקציה או באתר.הורדה של לוגו מפות Google
להשתמש בקובצי הלוגו הרשמיים של מפות Google. מורידים את הלוגו הרלוונטי מהרשימה שלמטה ופועלים לפי ההנחיות שבקטע הזה.
הורדת נכסי השיוך של מפות Googleכשמשתמשים בלוגו של מפות Google, צריך לפעול לפי ההנחיות האלה.
- אסור לשנות את הלוגו בשום צורה.
- חשוב לשמור על יחס הגובה-רוחב של הלוגו כדי למנוע עיוות.
- משתמשים בלוגו עם הקו המתאר על רקע עמוס, כמו מפה או תמונה.
- השתמשו בלוגו ללא קו מתאר על רקע פשוט, כמו צבע אחיד או מעבר צבע עדין.
מפרט גודל הלוגו
הלוגו של מפות Google צריך לעמוד במפרט הגודל הבא:- גובה הלוגו המינימלי: 16dp
- גובה מקסימלי של הלוגו: 19dp
- השטח הפנוי המינימלי מסביב ללוגו: 10dp משמאל, מימין ומלמעלה, 5dp מלמטה
מידע נוסף על dp זמין במאמר Pixel density באתר Material Design.
נגישות הלוגו
הדרישות הבאות בנוגע לנגישות חלות על הלוגו של מפות Google:- חשוב לשמור על ניגודיות נגישה בין הלוגו לרקע.
- כוללים תווית נגישות עם הטקסט מפות Google.
טקסט לציון קרדיט
אם הגודל של הממשק לא מאפשר להשתמש בלוגו של מפות Google, אפשר לכתוב את המילים מפות Google בטקסט. בצע את ההנחיות הבאות:
- אל תשנו את הטקסט מפות Google בשום צורה:
- אל תשנו את האותיות הרישיות במונח מפות Google
- לא להעביר את מפות 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 Maps Platform לבין תוכן אחר, צריך להשתמש ברמזים בממשק המשתמש, כמו גבול, צבע רקע, צל או רווח לבן מספיק.
- אל תציגו מצג שווא של מפות Google על ידי שיוך תוכן שלא שייך לפלטפורמה של מפות Google למפות Google.
- מוודאים שהשיוך תמיד גלוי וקריא. אסור להסיר, להסתיר, לטשטש או לשנות את התוכן הזה.
בדוגמאות הבאות אפשר לראות איך הדרישות האלה נראות.
ספקי נתונים של צד שלישי
חלק מהנתונים והתמונות במוצרי המיפוי שלנו מגיעים מספקים שאינם 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 בנושא תוכן שנוצר על ידי משתמשים (UGC)
סיכומים מבוססי-AI
כשמציגים סיכומים מבוססי-AI באפליקציה – כולל סיכומים של מקומות, אזורים וביקורות – צריך לבצע את הפעולות הבאות:
- להציג את הקרדיטים הנדרשים, את הקישורים לדוחות ואת הקישורים למקורות המידע, כפי שמוגדר בהמשך.
- משתמשי הקצה צריכים להיות מסוגלים לקרוא את הטקסט המלא של התקציר כפי שהוא מסופק על ידי מפות 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 עסקים או מקומות ליד מיקום מסוים, מוצגות תוצאות מהסביבה הקרובה. שילוב של כמה גורמים – בעיקר רלוונטיות, מרחק ומידת הבולטוּת – עוזר להשיג את התוצאות הטובות ביותר בחיפוש. מידע נוסף".
תאימות לדין החל
אתם נדרשים לפעול בהתאם לכל החוקים הרלוונטיים בכל שלב. חשוב לזכור: יכול להיות ששיטות עבודה שסומנו כ(מומלצות) במדיניות הזו עדיין נדרשות על פי חוק. בנוסף, גם אם תפעלו בהתאם לכל הדרישות המפורטות ולשיטות המומלצות, לא מובטח שתהיו תואמים באופן מלא לעמידה בהוראות הדין בכל תחומי השיפוט. אם יש לך שאלות לגבי סטטוס התאימות שלך, מומלץ לפנות לייעוץ משפטי.