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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

כשמשתמשים ב-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 הבאות, בהתאם לשירות שבו אתם משתמשים:

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

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

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

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

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

משבצות ב-Street View

פרטי זכויות היוצרים והשיוך זמינים בתשובה למטא-נתונים של 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 ל-Unity

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

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