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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

התגובות ב-API של אריחי המפה עשויות לכלול גם כותרת ETag שאמורה להיות גם להיות מוטמעות בהתאם לתיעוד של פרוטוקול HTTP כשמבקשים אימות מחדש.

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

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

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

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

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

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

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

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

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

הצגת שיוך (Attribution) של נתונים מצד שלישי

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

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

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

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

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

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

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

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

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

קבלת פרטי שיוך (Attribution) וזכויות יוצרים מהשדה 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 ב-Street הצגת תגובות מ-Static API.

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

עבור משבצות תלת-ממדיות פוטוריאליות, נתוני השיוך מוחזרים בכל בקשה של משבצת. עליך לקבץ, למיין ולהציג בשורה, את כל הייחוסים עבור המוצגים tiles; בדרך כלל לאורך החלק התחתון של התצוגה. לדוגמה, אפשר למצוא את שיוך נתונים ב-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 for Unreal בתור כלי הרינדור, עליכם להציג יש להפעיל את השדה Show Credits on Screen (הצגת הקרדיטים במסך) World Outliner (מתאר העולם).

צסיום ל-Unity

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

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