מדיניות בנושא Maps JavaScript API

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

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

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

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

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

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

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

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

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

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

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

חשוב לזכור שמזהה המקום, המשמש לזיהוי ייחודי של מקום, פטור מההגבלות על שמירת נתונים במטמון. מזהה המקום מוחזר בשדה place_id בתשובות של Maps JavaScript API. במדריך הזה מוסבר איך שומרים, מרעננים ומנהלים מזהי מקומות.

הצגת תוצאות של Maps JavaScript API

ניתן להציג את התוצאות של Maps JavaScript API על מפת Google, או בלי מפה. אם רוצים להציג במפה תוצאות של Maps JavaScript API, התוצאות האלה צריכות להופיע במפה של Google. אסור להשתמש בנתונים של Maps JavaScript 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) של צד שלישי ולהציג את השיוך באפליקציה, פועלים לפי ההוראות הבאות.

אחזור שיוך ממקום

אם באפליקציה מוצגים פרטי ביקורות שהתקבלו באמצעות קריאה ל-Place.fetchFields, צריך להציג בה גם שיוך של צד שלישי לפרטי המקום שהתקבלו.

ה-API מחזיר אובייקט Place. כדי לאחזר שיוך מהאובייקט Place, משתמשים במאפיין Place.attributions, שמוחזר בכל בקשה (אין צורך לציין אותו באמצעות שדות). המאפיין מחזיר List של String אובייקטים, או null אם אין שיוכים. בקוד לדוגמה הבא מוצגת קבלת מקום ורישום של כל השיוך.

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen
  });

  // Call fetchFields, passing the desired data fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // Check for any place attributions.
  if (!place.attributions) {
      console.log('No attributions were found.');
      return;
  } else {
      // Log the place attribution
      for (var attribution of place.attributions) {
          console.log(attribution);
      }
  }

  

הצגת ביקורת

אובייקט Place יכול להכיל עד חמש ביקורות, וכל ביקורת מיוצגת על ידי אובייקט Review. אתם יכולים גם להציג את הביקורות האלה באפליקציה.

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

בדוגמה הבאה מוצגת אחזור של מקום, בדיקה של ביקורות והצגת הנתונים מהביקורת הראשונה:

  // Use place ID to create a new Place instance.
  const place = new Place({
    id: "ChIJpyiwa4Zw44kRBQSGWKv4wgA", // Faneuil Hall Marketplace, Boston, MA
  });

  // Call fetchFields, passing "reviews" and other needed fields.
  await place.fetchFields({
      fields: ["displayName", "formattedAddress", "location", "reviews"],
  });

  // If there are any reviews display the first one.
  if (!place.reviews) {
      console.log('No reviews were found.');
  } else {
      // Log the review count so we can see how many there are.
      console.log("REVIEW COUNT: " + place.reviews.length);

      // Get info for the first review.
      let reviewRating = place.reviews[0].rating;
      let reviewText = place.reviews[0].text;
      let authorName = place.reviews[0].authorAttribution.displayName;
      let authorUri = place.reviews[0].authorAttribution.uri;

      // Create a bit of HTML to add to the info window
      const contentString =
        '<div id="title"><b>' + place.displayName + '</b></div>' +
        '<div id="address">' + place.formattedAddress + '</div>' +
        '<a href="' + authorUri + '" target="_blank">Author: ' + authorName + '</a>' +
        '<div id="rating">Rating: ' + reviewRating + ' stars</div>' +
        '<div id="rating""><p>Review: ' + reviewText + '</p></div>';

      // Create an info window.
      infoWindow = new InfoWindow({
          content: contentString,
          ariaLabel: place.displayName,
      });

      // Add a marker for the place.
      const marker = new AdvancedMarkerElement({
          map,
          position: place.location,
          title: place.displayName,
      });

      // Show the info window.
      infoWindow.open({
          anchor: marker,
          map,
      });
  }
  

מידע נוסף על ביקורות על מקומות

הצגת קרדיטים לתמונה

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

כל רכיב במערך התמונות הוא מופע של Photo, שמכיל את המערך authorAttributions מסוג AuthorAttribution. השדות של האובייקט AuthorAttribution הם מחרוזות שמכילות את displayName, uri ו-photoUri של השיוך, או מחרוזת ריקה אם אין שיוכים שאפשר להציג.

אפשר לעיין במסמכי התיעוד בנושא תמונות של מקומות.

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

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

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

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

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

לחצן 2: אישור

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

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

שטח פנוי

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

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

קריאות

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

צבע

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

כשחלה את הקוד הבא על הטקסט '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;