מדיניות של Places API

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

הצגת תנאי השימוש ומדיניות הפרטיות

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

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

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

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

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

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

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

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

אפליקציות שמשתמשות ב-Places 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 בפינה הימנית התחתונה של המפה, והשיוך בפינה השמאלית התחתונה.

לשימוש על רקע בהיר	לשימוש על רקע כהה

קובץ ה-zip הבא מכיל את הלוגו של Google בגדלים המתאימים לאפליקציות למחשב, ל-Android ול-iOS. אסור לשנות את הלוגואים האלה או לשנות את הגודל שלהם בשום צורה.

הורדה: google_logo.zip

לא משנים את השיוך. אסור להסיר, להסתיר או לחתוך את פרטי השיוך. אסור להשתמש בסמלי לוגו של Google בתוך שורות טקסט (לדוגמה, "המפות האלה מגיעות מ-[Google_logo]").

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

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

אם אתם משתמשים בפלטפורמה של מפות Google במכשיר שבו לא ניתן להציג את השיוך, תוכלו לפנות לצוות המכירות של Google כדי לדון ברישיונות שמתאימים לתרחיש לדוגמה שלכם.

דרישות אחרות בנושא שיוך

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

הערה: הביקורות והתמונות שסופקו באמצעות Places API כפופות למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. כדי לדווח על תוכן שאתם או המשתמשים שלכם רוצים להסיר משירותי Google בכפוף למדיניות Google או לדינים החלים, תוכלו לעיין במאמר דיווח על תוכן ב-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, צריך למקם את שם המחבר בסמוך לביקורת. אם התמונה של המחבר זמינה בשדה השיוך של המחבר באובייקט Review, מומלץ לכלול את התמונה של המחבר ולקשר גם לפרופיל שלו. בתמונה הבאה מוצגת דוגמה לביקורת על פארק:

Google ממליצה גם להציג למשתמש הקצה את אופן המיון של הביקורות.

הערה: ברירת המחדל היא למיין את הביקורות לפי רלוונטיות. ב-API החדש, המיון לפי רלוונטיות הוא האפשרות היחידה.

כל ביקורת באובייקט Place של תגובה מיוצגת על ידי אובייקט Review. כדי להוסיף את האובייקט Review לתגובה, צריך לכלול את places.reviews (חיפוש בקרבת מקום וחיפוש טקסט) או את reviews (פרטי מקום) במסכת השדה של הבקשה.

השדות של האובייקט Review מכילים את השיוך, או שהם ריקים אם אין שיוך להצגה.

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

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

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

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

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

לחצן 2: אישור

סיכומים מבוססי-AI

כשמציגים סיכומים מבוססי-AI באפליקציה – כולל סיכומים של מקומות, אזורים וחוות דעת – צריך לבצע את הפעולות הבאות:

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

הצגת טקסט הגילוי הנאות לגבי סיכומים מבוססי-AI

כשמציגים סיכום מבוסס-AI מכל סוג, תמיד צריך לכלול את טקסט הגילוי הנאות המותאם לשוק המקומי (שמוצג בשדה disclosureText בגוף התשובה) מיד מתחת לסיכום. לעולם אל תשנו או תוסיפו לטקסט הגילוי הנאות שסופק על ידי ה-API.

תרשים 1: טקסט הגילוי הנאות מוצג כראוי מתחת לכל אחד משלושת סוגי הסיכומים מבוססי-ה-AI.

דרישות נוספות לסיכום של מקומות ואזורים

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

טקסט	דרישה
מידע על הסיכום הזה	הקישור הבא מפנה למאמר 'מאילו מקורות Google מקבלת מידע ואיך היא משתמשת בו בדפי מידע מקומיים': https://support.google.com/local-listings/answer/9851099.
סיכום הדוח	כדי לדווח ל-Google על בעיה בתוכן של סיכום, אפשר להשתמש בקישור שמופיע בשדה flagContentUri בתשובה. הערה: סיכומים מבוססי-AI שמוצגים דרך Places API (חדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. עליך להודיע למשתמשי הקצה שלך שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, עליהם לדווח עליו באמצעות כתובת ה-URL של התוכן שסומן (flagContentUri).

איור 2: סיכום אזור מבוסס-AI שמוצג עם קישורים משויכים נדרשים שזמינים למשתמשי הקצה באמצעות תפריט נוסף.

הדרישות לגבי סיכומים

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

טקסט	דרישה
מידע על הסיכום הזה	הקישור הבא מפנה למאמר 'מאילו מקורות Google מקבלת מידע ואיך היא משתמשת בו בדפי מידע מקומיים': https://support.google.com/local-listings/answer/9851099
סיכום הדוח	משתמשים בקישור שמופיע בשדה flagContentUri בתשובה. הערה: סיכומים מבוססי-AI שמוצגים דרך Places API (חדש) כפופים למדיניות התוכן ולמדיניות המוצרים של Google בכל מקום בעולם. עליך להודיע למשתמשי הקצה שלך שאם הם רוצים לדווח על תוכן שצריך להסיר משירותי Google בכפוף לדין החל, עליהם לדווח עליו באמצעות כתובת ה-URL של התוכן שסומן (flagContentUri).
לצפייה בביקורות	משתמשים בקישור שמופיע בשדה googleMapsLinks.reviewsUri בתשובה.

איור 3: סיכום ביקורת מבוסס-AI שמוצג עם קישורים משויכים נדרשים שזמינים למשתמשי הקצה באמצעות תפריט נוסף.

הנחיות להצגת תרחישי שימוש בתחום הרכב

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

• לא יותר מ-3 שורות
• 120 תווים או 24 מילים או פחות
• גודל מינימלי בחזית של 24dp

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

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

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

שטח פנוי

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

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

קריאות

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

צבע

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