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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

בדוגמה הבאה למפה, הלוגו של Google מופיע בפינה הימנית התחתונה של המפה, והשיוך מופיע בפינה השמאלית התחתונה.

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

הורדה: google_logo.zip

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

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

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

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

הצגת הלוגו של Google בעזרת כלים של צד שלישי לעיבוד

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

תמונה שרנדרה שמוצגים בה סמלי הלוגו של Google ו-Cesium

הצגת שיוך הנתונים של Google

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

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

כותרת תחתונה שמכילה את הלוגו של Google ואת השיוך לספק הנתונים.

הצגת שיוך נתונים של צד שלישי

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

הצגת ייחוס של לוגו ונתונים באמצעות תצוגות חזותיות היברידיות

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

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

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

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

יצירת סרטונים עם Map Tiles API

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

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

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

אריחי מפת כבישים, לוויין ופני שטח

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

{
  "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 הסטטיות של תצוגת הרחוב.

קטעי מפה ריאליסטיים בתלת-ממד

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

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

CesiumJS

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

// 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,
    }));

Cesium ל-Unreal

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

איך מפעילים את השיוך ל-Cesium for Unreal

Cesium ל-Unity

אם אתם משתמשים ב-Cesium for Unity כמפעיל, כדי להציג את הקרדיטים צריך להפעיל את השדה Show Credits On Screen במסוף Inspector.

איך מפעילים את השיוך ל-Cesium for Unity

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

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