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

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

הצגת התנאים וההגבלות ומדיניות הפרטיות

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

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

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

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

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

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

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

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

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

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

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

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

דרישות אחרות לגבי שיוך (Attribution)

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

אחזור ייחוסים ממקום מסוים

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

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

  // 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, יש למקם את שם המחבר בקרבה קרובה. אם האפשרות זמינה בשדה Attribution של המחבר באובייקט Review, מומלץ לכלול גם את התמונה של המחבר וקישור לפרופיל שלו. התמונה הבאה מציגה דוגמה לסקירה של פארק:

תצוגת ייחוס של מחבר

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

  // Use place ID to create a new Place instance.
  const place = new Place({
      id: 'ChIJB9a4Ifl744kRlpz0BQJzGQ8', // Crazy Good Kitchen, 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 שניתן להוריד, ריכזנו כאן הנחיות בנושא סגנון של ייחוס Google ב-CSS וב-HTML.

שטח פנוי

השטח הפנוי מסביב לנעילה צריך להיות שווה לגובה האות 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;