הצטרפו אלינו לאירוע הבא של Google Maps Platform Developer Community Day בסן פרנסיסקו בדצמבר. להגשת בקשה להשתתפות.

‫Google משתמשת בטכנולוגיית AI כדי לתרגם תוכן לשפה המועדפת עליך. בתרגומים כאלו עשויות להיות שגיאות.

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

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

מדיניות

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

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

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

הדפסה

אסור להשתמש בתמונות Street View למטרות הדפסה, כפי שמפורט במדיניות Street View.

מדינות וטריטוריות באזור הכלכלי האירופי (EEA)

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

אם הכתובת שלכם לחיוב לא נמצאת ב-EEA, התנאים וההגבלות הבאים חלים עליכם:

הצגת השיוך (Attribution) של מפות Google

תמונה מעובדת שמוצגים בה ייחוסים של מפות Google והנתונים בחשבון Google — השיוך (Attribution) של מפות Google הוחל על מפה באמצעות Map Tiles API

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

שיוך הלוגו

הלוגו של מפות Google

השתמשו בסמלי הלוגו הרשמיים של מפות Google שמופיעים בהמשך.

הורדת נכסי השיוך של מפות Google

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

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

מפרט הגודל של הלוגו

הנחיות לגבי הגודל של הלוגו של מפות Google:

גובה מינימלי של הלוגו: 16dp
גובה מקסימלי של הלוגו: 19dp
שטח פנוי מינימלי מסביב ללוגו: 10dp משמאל, מימין ומלמעלה, 5dp מלמטה

למידע נוסף על dp, אפשר לעיין בקטע צפיפות פיקסלים באתר Material Design.

נגישות של הלוגו

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

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

הצגת הלוגו של מפות Google עם כלי רינדור של צד שלישי

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

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

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

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

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

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

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

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

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

הצגת הלוגו ושיוך הנתונים בתצוגות חזותיות משולבות

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

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

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

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

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

סרטונים שיווקיים: מותר ליצור סרטונים שיווקיים בכפוף לתנאי ההסכם ולתנאים הבאים:

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

הסרה: באחריותך לציית לכל הבקשות להסרת סרטון הקידום, כולל בקשות מצדדים שלישיים.

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

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

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

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

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

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

משבצות ב-Street View

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

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0",
  …
}

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

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

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

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

Cesium for Unreal

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

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

Cesium ל-Unity

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

איך מפעילים שיוך (Attribution) ב-Cesium for Unity

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