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

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

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

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

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

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

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

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

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

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

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

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

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

הצגת תוצאות של 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

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

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

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

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

שטח פנוי

כמות השטח הפנוי מסביב ללוגו צריך להיות שווה לגובה או גדול ממנו של האות G ב-Google.

הרווח בין עותק הייחוס לבין הלוגו של Google צריך להיות חצי מהרוחב של עם האות G.

קריאות

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

צבע

שימוש בטקסט אפור 700 מסוג Google Material אפור 700 על רקע לבן או בהיר עם טווח של 0% עד 40% גוון מקסימלי של שחור.

#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

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

#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;