מדיניות API של אריחי מפה

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

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

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

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

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

אפליקציה לנייד

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

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

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

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

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

באופן ספציפי, אפליקציות צריכות להשתמש בממשק ה-API של אריחי המפה כדי להציג תצוגות חזותיות של המפה. אסור להשתמש ב- MapMaps API לתרחישים לדוגמה שאינם רכיבים חזותיים, למשל:

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

תגובות של Map Maps API עשויות לכלול כותרות Cache-Control, שצריך להטמיע בהתאם למסמכי התיעוד של פרוטוקול HTTP. לדוגמה, הלקוח שלכם צריך לכבד את הערך max-age, את הערך stale-while-revalidate, את ההוראה must-revalidate ואת ההוראה private כאשר הם מועברים בתגובה.

התגובות של Map Maps API עשויות לכלול גם כותרת ETag, שצריך להטמיע בהתאם לתיעוד של פרוטוקול HTTP כששולחים בקשה לאימות מחדש.

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

הצגת הלוגו של Google

כשמשתמשים בממשק ה-API של משבצות המפה כדי להציג את מפות 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 כדי לדון ברישיונות שמתאימים לתרחיש לדוגמה שלכם.

הצגת הלוגו של Google באמצעות כלי רינדור מצד שלישי

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

הצגת ייחוסי הנתונים של Google

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

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

הצגת ייחוסי נתונים של צד שלישי

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

הצגת ייחוסי לוגו ונתונים בתצוגות חזותיות היברידיות

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

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

שכבות-על של נתונים גיאוגרפיים עם אריחים פוטוריאליסטיים בתלת-ממד

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

יצירת סרטון באמצעות ממשק API של אריחי מפה

• סרטונים לקידום מכירות: ניתן ליצור סרטונים של קידום מכירות בכפוף לתנאי ההסכם, כמו גם לתנאים הבאים:
• הסרטון לקידום מכירות לא יכול לכלול תמונות Street View.
• משך הסרטון השיווקי לא יכול להיות יותר מ-30 שניות.
• הסרטון השיווקי צריך לעסוק ביכולות של האפליקציות שלך.
• סרטון קידום המכירות צריך להיות מסומן בבירור "למטרות קידום מכירות בלבד", ועליו לעמוד בהנחיות השיוך שבמדיניות API של אריחי מפה.
• אין להפיץ את הסרטון השיווקי בנפרד או כחלק מהתוכנה, מהאפליקציה או מחוויית המשתמש.
• הסרה: באחריותך לציית לכל הבקשות להסרה של סרטון קידום המכירות, כולל בקשות מצד שלישי.

אחזור מידע על ייחוס וזכויות יוצרים

מקבלים מידע על שיוך וזכויות יוצרים מהשדה copyright בתשובות לקריאות הבאות ל-API, בהתאם לשירות שבו משתמשים:

• קטעי מפה
• אריחים ב-Street View
• משבצות פוטוריאליסטיות בתלת-ממד

משבצות דו-ממדיות

מפת דרכים, קטעי לוויין ושטח

המידע על זכויות היוצרים והשיוך זמין בתגובה למידע על אזור התצוגה, כפי שמוצג בדוגמה הבאה.

{
  "copyright": "Map data ©2023",
  "maxZoomRects": [
    {
      "maxZoom": 19,
      "north": 90,
      "south": -90,
      "east": 180,
      "west": -180
    },
    ...
  ]
}

אריחים ב-Street View

המידע על זכויות היוצרים והשיוך (Attribution) זמין בתשובה למטא-נתונים של Street View. לדוגמה:

{
  "panoId": "Zzl28rqGJgaL2IdkUleP8A",
  "lat": 50.059138596550696,
  "imageHeight": 6656,
  "imageWidth": 13312,
  "tileHeight": 512,
  "tileWidth": 512,
  "copyright": "From the Owner, Photo by: Google",
  …
}

מזהה הפנורמה, שמשמש לזיהוי ייחודי של תמונת פנורמה ב-Street View, לא נכלל בהגבלת השמירה במטמון. לכן, אפשר לשמור ערכים של מזהה פנורמה ללא הגבלה. הערכים של מזהי הפנורמה מוחזרים בשדה panoId בתגובות של API סטטי של Street View.

אריחים פוטוריאליסטיים בתלת-ממד

במשבצות תלת-ממדיות פוטוריאליסטיות מוחזרות נתוני השיוך בכל בקשת משבצת. צריך לקבץ, למיין ולהציג בשורה את כל הייחוסים של האריחים המוצגים. בדרך כלל בחלק התחתון של הרינדור. לדוגמה, אפשר למצוא את השיוך של הנתונים במשבצת glTF על ידי חיפוש מתחת ל-asset, copyright.

{
  "asset": {
    "version": "2.0",
    "generator": "draco_decoder",
    "copyright": "Data SIO, NOAA, U.S. Navy, NGA, GEBCO;Landsat / Copernicus"
  }
}

CesiumJS

אם משתמשים ב-CesiumJS בתור הרינדור, אז כדי להציג שיוך, צריך להפעיל את showCreditsOnScreen ברינדור ה-HTML.

// Add Photorealistic 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));

צסיום ל-Unreal

אם אתם משתמשים ב-Cesium ל-Unreal בתור הכלי לעיבוד, תצטרכו להפעיל את השדה Show Credits On Screen ב-World Outliner.

צסיום ל-Unity

אם אתם משתמשים ב-Cesium ל-Unity בתור כלי הרינדור, עליכם להפעיל את השדה Show Credits On Screen במסוף המפקח.

הנחיות בנושא סגנון לשיוך ב-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;