خط‌مشی‌های Map Tiles API

این سند الزامات برنامه‌های توسعه‌یافته با Map Tiles API را فهرست می‌کند. توجه داشته باشید که استفاده از Map Tiles API تحت کنترل «قرارداد» شما با Google است.

خط‌مشی‌ها

این بخش خط‌مشی‌های مربوط به Map Tiles API را شرح می‌دهد. خط‌مشی‌ها دستورالعمل‌ها و الزامات اجرایی کاربردی را ارائه می‌دهند تا به شما کمک کنند از «سرویس» به‌درستی و مطابق با انتظارات «پلاتفرم Google Maps» استفاده کنید.

پیش‌واکشی، ذخیره‌سازی موقت، یا ذخیره‌سازی محتوا

برنامه‌هایی که از 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 هنگام درخواست با اعتبارسنجی مجدد پیاده‌سازی شود.

چاپ کردن

همان‌طور که در خط‌مشی‌های «نمای خیابان» ذکر شده است، از تصاویر «نمای خیابان» نباید برای اهداف چاپی استفاده شود.

کشورها و قلمروهای منطقه اقتصادی اروپا

این محصول برای مشتریانی که نشانی صورت‌حسابشان در منطقه اقتصادی اروپا (EEA) است، «شرایط خدمات» متفاوتی دارد و ممکن است عملکرد آن نیز متفاوت باشد. قبل‌از ساختن با Google Maps Platform، شرایط و اطلاعات زیر را که مختص منطقه اقتصادی اروپا است مرور کنید:

اگر نشانی صورت‌حساب شما در منطقه اقتصادی اروپا نیست، شرایط خدمات زیر برای شما اعمال می‌شود:

تصویر پردازش‌شده‌ای که Google Maps و ارجاع‌های داده‌های Google را نشان می‌دهد
ارجاع Google Maps اعمال‌شده به نقشه بااستفاده از Map Tiles API

هنگام نمایش محتوا از میاناهای برنامه‌سازی کاربردی Google Maps Platform در برنامه یا وب‌سایتتان، باید به‌طور واضح به Google Maps ارجاع دهید. ارجاع باید هر زمان ممکن است به‌شکل نشان‌واره Google Maps باشد. در مواردی که فضا محدود است، نوشتار Google Maps قابل‌قبول است.

ارجاع نشان‌واره

انواع قابل‌قبول برای ارجاع نشان‌واره Google Maps
انواع قابل‌قبول برای ارجاع نشان‌واره Google Maps

نشان‌واره Google Maps

از نشان‌واره‌های رسمی Google Maps که در زیر ارائه شده است استفاده کنید.

بارگیری دارایی‌های ارجاع Google Maps

هنگام استفاده از نشان‌واره Google Maps، این دستورالعمل‌ها را دنبال کنید.

  • به هیچ وجه نشان‌واره را تغییر ندهید.
  • نسبت ابعادی نشان‌واره را حفظ کنید تا از اعوجاج جلوگیری شود.
  • از نشان‌واره با خط پیرامونی روی پس‌زمینه شلوغ، مثل نقشه یا تصویر، استفاده کنید.
  • از نشان‌واره بدون حاشیه روی پس‌زمینه ساده، مثل رنگ یکدست یا گرادیان ملایم، استفاده کنید.

مشخصات اندازه نشان‌واره

این مشخصات اندازه را برای نشان‌واره Google Maps دنبال کنید:

  • حداقل ارتفاع نشان‌واره: ۱۶ پیکسل مستقل از تراکم
  • حداکثر ارتفاع نشان‌واره: ۱۹ پیکسل مستقل از تراکم
  • حداقل فضای خالی نشان‌واره: ۱۰ پیکسل مستقل از تراکم در چپ، راست، و بالا، ۵ پیکسل مستقل از تراکم در پایین

برای آشنایی با dp، به تراکم پیکسل در وب‌سایت Material Design مراجعه کنید.

نشان‌واره Google Maps که حداقل فضای خالی و محدوده اندازه قابل‌قبول را نشان می‌دهد
نمایش نشان‌واره Google Maps که حداقل فضای خالی و محدوده اندازه قابل‌قبول را نشان می‌دهد

دسترس‌پذیری نشان‌واره

این الزامات دسترس‌پذیری را برای نشان‌واره Google Maps دنبال کنید:

  • کنتراست دسترس‌پذیری بین نشان‌واره و پس‌زمینه را حفظ کنید.
  • برچسب دسترس‌پذیری با نوشتار Google Maps را اضافه کنید.

نمایش نشان‌واره Google Maps با پردازنده طرف سوم

وقتی از Map Tiles API برای نمایش Google Maps بااستفاده از پردازنده شخص ثالث استفاده می‌کنید، نباید نشان‌واره Google را با نشان‌واره دیگری، مثل نشان‌واره پردازنده، هم‌پوشانی کنید یا بپوشانید. فاصله حائل معقولی بین نشان‌واره Google و نشان‌واره شخص ثالث حفظ کنید تا به‌عنوان نشان‌واره‌های مستقل دیده شوند. هیچ نشان‌واره‌ای نباید با ارجاع داده ارائه‌شده توسط پاسخ میانای برنامه‌سازی کاربردی هم‌پوشانی داشته باشد یا آن را پنهان کند.

تصویر پردازش‌شده‌ای که نشان‌واره‌های Google و Cesium را نشان می‌دهد

نمایش ارجاع‌های داده‌های Google

داده‌های برگشتی از Map Tiles API مستلزم نمایش اطلاعات ارجاع و حق نشر از فراداده مناسب یا درخواست‌های اطلاعات نمای هدف است. باید این اطلاعات را به‌طور کامل همان‌طور که در مکان مناسب ارائه شده است، معمولاً در گوشه پایین سمت چپ مجموعه کاشی‌های نمایش‌داده‌شده یا در نمای پردازنده سه‌بعدی، نمایش دهید. توجه داشته باشید که رشته‌های ارجاع متغیر هستند و به داده‌های نقشه درخواست‌شده توسط نمای نقشه پردازنده بستگی دارند.

اگر به‌دلیل محدودیت‌های اندازه نمای هدف، نمایش کامل ارجاع‌های داده امکان‌پذیر نیست، عنصر میانای کاربر قابل‌کلیک یا با قابلیت نگه داشتن نشانگر روی آن را با برچسب «منابع داده» اضافه کنید که در پنجره نقشه باز می‌شود تا اطلاعات ارجاع را ارائه دهد. همیشه سعی کنید روش‌های خوب نقشه‌نگاری را حفظ کنید.

پانویس حاوی نشان‌واره Google و ارجاع به ارائه‌دهنده داده.

نمایش ارجاع‌های داده‌های طرف سوم

برخی‌از داده‌ها و تصاویر موجود در محصولات نقشه‌برداری ما از ارائه‌دهندگانی غیراز Google دریافت می‌شود. برای برخی‌از محصولات، مانند Map Tiles API، ممکن است ارجاع لازم به ارائه‌دهنده داده طرف سوم را به شما ارائه دهیم. وقتی این کار را انجام می‌دهیم، متن ارجاع شما باید نام «Google Maps» و ارائه‌دهنده(های) داده مربوطه را ذکر کند، مانند «داده‌های نقشه: Google، Maxar Technologies». وقتی Google ارجاع به طرف سوم ارائه می‌دهد، فقط گنجاندن «Google Maps» یا نشان‌واره Google ارجاع مناسبی نیست.

وقتی از Map Tiles API برای نمایش داده‌های Google Maps به‌عنوان نقشه پایه و هم‌پوشانی داده‌های زمین‌مکانی شخص ثالث (غیرGoogle) استفاده می‌کنید، نباید به‌هیچ‌وجه ذکر منبع داده‌های Google را با ذکر منبع داده‌های شخص ثالث هم‌پوشانی کنید یا آن را پنهان کنید. اسناد داده‌های طرف سوم باید به‌وضوح از اسناد داده‌های Google جدا شود. علاوه‌براین، باید مشخص باشد که نشان‌واره Google Maps و ذکر منبع داده‌های Google با نقشه پایه و با یکدیگر مرتبط هستند.

نمایش نشان‌واره و ارجاع‌های داده در دیداری‌سازی‌های ترکیبی

وقتی از داده‌های Google Maps به‌عنوان نقشه پایه استفاده می‌کنید و داده‌های نقشه خودتان را روی آن قرار می‌دهید، باید مطمئن شوید مخاطبانتان کاملاً متوجه می‌شوند کدام بخش از نقشه بصری به Google نسبت داده می‌شود و کدام بخش‌ها به داده‌های نقشه خودتان نسبت داده می‌شود. علاوه‌براین، از دستورالعمل‌های بخش نمایش ذکر منبع Google Maps در بالا پیروی کنید.

به‌عنوان مثال، ترکیب «کاشی‌های سه‌بعدی واقع‌نما» (به‌عنوان پرکننده پس‌زمینه) با مدل‌های واقع‌نمای خودتان (در پیش‌زمینه) را درنظر بگیرید. ممکن است کاربران درباره اینکه کدام مؤلفه‌های صحنه از داده‌های Google Maps منشأ می‌گیرند گیج شوند. در چنین مواردی، باید در رشته ذکر منبع واسط کاربر یا جریان کاربر به‌وضوح بیان کنید کدام بخش از صحنه از داده‌های Google Maps منشأ می‌گیرد. شما مسئول رعایت هرگونه الزامات ذکر منبع شخص ثالث هستید که ممکن است برای منابع داده‌ای که با داده‌های Google Maps استفاده می‌کنید اعمال شود.

هم‌پوشانی‌های داده‌های جغرافیایی با «کاشی‌های سه‌بعدی واقع‌نما»

می‌توانید اشیای سه‌بعدی خودتان را روی «کاشی‌های سه‌بعدی واقع‌نما» هم‌پوشانی کنید، به‌شرطی که این اشیای سه‌بعدی از «کاشی‌های سه‌بعدی واقع‌نما» استخراج، ردیابی، یا به‌صورت دستی یا ماشینی مشتق نشده باشند.

ایجاد ویدیو با Map Tiles API

  • ویدیوهای تبلیغاتی: می‌توانید ویدیوهای تبلیغاتی را مشروط به شرایط «قرارداد» و موارد زیر ایجاد کنید:
    • ویدیو تبلیغاتی نباید حاوی تصاویر «نمای خیابان» باشد.
    • طول ویدیو تبلیغاتی نباید بیشتر از ۳۰ ثانیه باشد.
    • ویدیو تبلیغاتی باید درباره قابلیت‌های برنامه(های) شما باشد.
    • ویدیو تبلیغاتی باید به‌وضوح با عبارت «فقط برای اهداف تبلیغاتی» علامت‌گذاری شود و باید از دستورالعمل‌های نمایش ارجاع Google Maps پیروی کند.
    • ویدیو تبلیغاتی نباید به‌صورت جداگانه یا به‌عنوان بخشی از نرم‌افزار، برنامه، یا تجربه کاربری بازفروشی شود.
  • حذف: شما مسئول رعایت همه درخواست‌های حذف «ویدیو تبلیغاتی» هستید، ازجمله درخواست‌های اشخاص ثالث.

اطلاعات ارجاع و حق نشر را از فیلد copyright در پاسخ‌های فراخوانی‌های میانای برنامه‌سازی کاربردی زیر، بسته به سرویسی که استفاده می‌کنید، دریافت کنید:

کاشی‌های دوبُعدی

کاشی‌های نقشه راه، ماهواره، و عوارض زمین

اطلاعات حق نشر و ارجاع از پاسخ اطلاعات نمای دید دردسترس است، همان‌طور که در مثال زیر نشان داده شده است.

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

کاشی «نمای خیابان»

اطلاعات حق نشر و ارجاع ازطریق پاسخ فراداده «نمای خیابان» دردسترس است. برای مثال:

{
 "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",
  …
}

شناسه تمام‌نما، که برای شناسایی منحصربه‌فرد تمام‌نمای «نمای خیابان» استفاده می‌شود، از محدودیت ذخیره‌سازی در حافظه نهان معاف است. بنابراین، می‌توانید مقادیر شناسه تمام‌نما را به‌طور نامحدود ذخیره کنید. مقادیر شناسه تمام‌نما در فیلد panoId در پاسخ‌های Street View Static API برگردانده می‌شود.

باید اَبَرپیوند 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 برای Unreal به‌عنوان پردازنده استفاده می‌کنید، برای نمایش ارجاع‌ها، باید فیلد نمایش اعتبارها در صفحه را در World Outliner فعال کنید.

نحوه فعال کردن ارجاع‌ها برای Cesium برای Unreal

Cesium for Unity

اگر از Cesium برای Unity به‌عنوان پردازنده گرافیکی استفاده می‌کنید، برای نمایش منبع، باید فیلد نمایش اعتبار در صفحه را در کنسول Inspector فعال کنید.

نحوه فعال کردن ارجاع‌ها برای Cesium for Unity