ایجاد و مدیریت یک مجموعه داده

مجموعه داده‌ها به شما امکان می‌دهند داده‌های مکانی را از یک فایل محلی یا از Google Cloud Storage در پلتفرم Google Maps آپلود کنید. سپس می توانید یک مجموعه داده را با یک یا چند سبک نقشه در Cloud Console مرتبط کنید. پس از مرتبط کردن مجموعه داده با سبک نقشه‌ها، از API سبک مبتنی بر داده برای استایل کردن پویا به برنامه نقشه خود استفاده کنید.

همچنین می توانید از یک REST API برای آپلود داده های مکانی خود در یک مجموعه داده استفاده کنید. برای اطلاعات بیشتر، Maps Datasets API را ببینید

پیکربندی نقش ها

برای ایجاد و مدیریت مجموعه‌های داده در پروژه Google Cloud، باید نقش مالک یا ویرایشگر IAM در پروژه را نگه دارید.

همچنین، می‌توانید نقش‌های IAM زیر را به حساب کاربری یا حساب سرویسی که برای مدیریت مجموعه داده‌ها استفاده می‌کنید، اختصاص دهید:

  • نقش Maps Platform Datasets Admin به کاربر یا حساب سرویس دسترسی خواندن/نوشتن به مجموعه داده‌های پروژه را می‌دهد. این نقش به کاربر این امکان را می دهد که تمام عملیات روی یک مجموعه داده را انجام دهد.
  • نقش Maps Platform Datasets Viewer به مجموعه داده‌های پروژه دسترسی فقط خواندنی می‌دهد. این نقش به شما امکان می دهد عملیات لیست، دریافت یا دانلود را روی یک مجموعه داده انجام دهید.

برای اطلاعات بیشتر، به اعطای نقش IAM با استفاده از کنسول Google Cloud مراجعه کنید.

منبع داده برای یک مجموعه داده

پس از ایجاد یک مجموعه داده، داده ها را از Google Cloud Storage یا از یک فایل محلی در مجموعه داده آپلود کنید.

  • هنگام آپلود داده ها از فضای ذخیره سازی ابری، مسیر فایل را به منبع حاوی داده ها در فضای ذخیره سازی ابری مشخص کنید. این مسیر به شکل gs:// GCS_BUCKET / FILE است.

    کاربر درخواست کننده به نقش Storage Object Viewer یا هر نقش دیگری که شامل مجوز storage.objects.get باشد نیاز دارد. برای اطلاعات بیشتر در مورد مدیریت دسترسی به فضای ذخیره‌سازی ابری، به نمای کلی کنترل دسترسی مراجعه کنید.

  • هنگام آپلود داده‌ها از یک فایل محلی، مسیر فایل GeoJSON، KML یا CSV حاوی داده‌های آپلود را مشخص کنید.

پیش نیازها

هنگام ایجاد یک مجموعه داده:

  • نام‌های نمایشی باید در پروژه Google Cloud شما منحصربه‌فرد باشند.
  • نام های نمایشی باید کمتر از 64 بایت باشند (از آنجایی که این کاراکترها در UTF-8 نشان داده می شوند، در برخی از زبان ها هر کاراکتر را می توان با چندین بایت نشان داد).
  • توضیحات باید کمتر از 1000 بایت باشد.

هنگام آپلود داده ها:

  • انواع فایل های پشتیبانی شده CSV، GeoJSON و KML هستند.
  • حداکثر اندازه فایل پشتیبانی شده 350 مگابایت است.
  • نام ستون های مشخصه نمی تواند با رشته "?_" شروع شود.
  • هندسه های سه بعدی پشتیبانی نمی شوند. این شامل پسوند "Z" در قالب WKT و مختصات ارتفاع در قالب GeoJSON است.

الزامات GeoJSON

Maps JavaScript API از مشخصات GeoJSON فعلی پشتیبانی می کند. Maps JavaScript API همچنین از فایل‌های GeoJSON که حاوی هر یک از انواع شیء زیر هستند پشتیبانی می‌کند:

  • اجسام هندسی شیء هندسی یک شکل فضایی است که به عنوان اتحاد نقاط، خطوط و چندضلعی ها با سوراخ های اختیاری توصیف می شود.
  • اشیاء را مشخص کنید . یک شیء ویژگی شامل یک هندسه به اضافه جفت‌های نام/مقدار اضافی است که معنای آن‌ها مختص کاربرد است.
  • مجموعه های ویژه مجموعه ویژگی مجموعه ای از اشیاء ویژگی است.

Maps JavaScript API از فایل‌های GeoJSON که داده‌هایی در یک سیستم مرجع مختصات (CRS) غیر از WGS84 دارند، پشتیبانی نمی‌کند.

برای اطلاعات بیشتر در مورد GeoJSON، مطابق با RFC 7946 را ببینید.

الزامات KML

Maps JavaScript API شرایط زیر را دارد:

  • همه URL ها باید محلی (یا نسبی) به خود فایل باشند.
  • هندسه نقطه، خط و چند ضلعی پشتیبانی می شود.
  • تمام ویژگی های داده رشته ها در نظر گرفته می شوند.
ویژگی های KML زیر پشتیبانی نمی شوند:
  • نمادها یا <styleUrl> که خارج از فایل تعریف شده است.
  • پیوندهای شبکه، مانند <NetworkLink>
  • پوشش های زمینی، مانند <GroundOverlay>
  • هندسه های سه بعدی یا هر برچسب مرتبط با ارتفاع مانند <altitudeMode>
  • مشخصات دوربین مانند <LookAt>
  • سبک های تعریف شده در داخل فایل KML.

الزامات CSV

برای فایل‌های CSV، نام ستون‌های پشتیبانی‌شده به ترتیب اولویت در زیر فهرست شده‌اند:

  • طول latitude longitude
  • lat ، long
  • x ، y
  • wkt (متن معروف)
  • address ، city ، state ، zip
  • address
  • یک ستون شامل تمام اطلاعات آدرس، مانند 1600 Amphitheatre Parkway Mountain View, CA 94043

به عنوان مثال، فایل شما حاوی ستون هایی با نام های x ، y و wkt است. از آنجایی که x و y اولویت بیشتری دارند، همانطور که با ترتیب نام ستون های پشتیبانی شده در لیست بالا مشخص می شود، از مقادیر ستون های x و y استفاده می شود و ستون wkt نادیده گرفته می شود.

علاوه بر این:

  • نام هر ستون باید متعلق به یک ستون باشد. یعنی شما نمی توانید ستونی به نام xy داشته باشید که حاوی داده های مختصات x و y باشد. مختصات x و y باید در ستون های جداگانه باشند.
  • نام ستون ها به حروف بزرگ و کوچک حساس نیستند.
  • ترتیب نام ستون ها مهم نیست. به عنوان مثال، اگر فایل CSV شما حاوی ستون های lat و long باشد، می توانند به هر ترتیبی رخ دهند.

رسیدگی به خطاهای آپلود داده ها

هنگام آپلود داده ها در یک مجموعه داده، ممکن است یکی از خطاهای رایج شرح داده شده در این بخش را تجربه کنید.

خطاهای GeoJSON

خطاهای رایج GeoJSON عبارتند از:

  • فیلد type وجود ندارد، یا type رشته نیست. فایل داده GeoJSON آپلود شده باید دارای یک فیلد رشته ای به نام type به عنوان بخشی از هر شی Feature و تعریف شی هندسه باشد.

خطاهای KML

خطاهای رایج KML عبارتند از:

  • فایل داده نباید دارای هیچ یک از ویژگی های KML پشتیبانی نشده ذکر شده در بالا باشد، در غیر این صورت ممکن است وارد کردن داده ها با شکست مواجه شود.

خطاهای CSV

خطاهای رایج CSV عبارتند از:

  • برخی از سطرها مقادیری برای یک ستون هندسه ندارند. همه ردیف‌های یک فایل CSV باید حاوی مقادیر غیر خالی برای ستون‌های هندسه باشند. ستون های هندسی عبارتند از:
    • طول latitude longitude
    • lat ، long
    • x ، y
    • wkt
    • address ، city ، state ، zip
    • address
    • یک ستون شامل تمام اطلاعات آدرس، مانند 1600 Amphitheatre Parkway Mountain View, CA 94043
  • اگر x و y ستون های هندسی شما هستند، مطمئن شوید که واحدها طول و عرض جغرافیایی هستند. برخی از مجموعه داده های عمومی از سیستم های مختصات متفاوتی در زیر سربرگ های x و y استفاده می کنند. اگر از واحدهای اشتباه استفاده شود، مجموعه داده ممکن است با موفقیت وارد شود، اما داده های ارائه شده می توانند نقاط داده را در مکان های غیرمنتظره نشان دهند.

یک مجموعه داده ایجاد کنید

برای ایجاد یک مجموعه داده:

  1. در Google Cloud Console، به صفحه Datasets بروید .
  2. روی ایجاد مجموعه داده کلیک کنید.
  3. نام مجموعه داده را وارد کنید. نام باید در بین همه مجموعه داده ها منحصر به فرد باشد.
  4. به صورت اختیاری توضیحات مجموعه داده را وارد کنید.
  5. روی Continue کلیک کنید. صفحه Import data ظاهر می شود.
  6. منبع آپلود داده‌های مورد استفاده برای پر کردن مجموعه داده‌ها را به‌عنوان دسکتاپ انتخاب کنید، به معنی یک فایل محلی در سیستم خود یا سطل فضای ذخیره‌سازی Google Cloud .
    • برای دسکتاپ ، روی Browse کلیک کنید و سپس فایل را از انتخابگر فایل انتخاب کنید.
    • برای Google Cloud Storage سطل ، روی Browse کلیک کنید و سطل و فایل حاوی داده را انتخاب کنید.
  7. فرمت فایل را انتخاب کنید.
  8. برای بررسی تنظیمات خود روی Continue کلیک کنید.
  9. روی ایجاد کلیک کنید. صفحه Datasets ظاهر می شود که مجموعه داده جدید شما را نشان می دهد. وضعیت باید در حال پردازش باشد.
  10. منتظر بمانید تا مجموعه داده شما به وضعیت تکمیل شده برسد.

مشاهده یا اصلاح یک مجموعه داده

پس از اینکه یک مجموعه داده را با موفقیت ایجاد کردید، وضعیت آن به عنوان تکمیل شده ظاهر می شود. سپس می توانید جزئیات مجموعه داده را بررسی کنید.

برای مشاهده مجموعه داده:

  1. در Google Cloud Console، به صفحه Datasets بروید .
  2. روی نام مجموعه داده کلیک کنید. صفحه جزئیات Dataset ظاهر می شود.
    1. برای مشاهده اطلاعات مربوط به مجموعه داده، روی برگه جزئیات کلیک کنید. در این برگه می توانید نام و توضیحات مجموعه داده را نیز ویرایش کنید.
    2. برای مشاهده مجموعه داده خود بر روی نقشه، روی تب Preview کلیک کنید.
    3. برای مشاهده زیرمجموعه ای از داده های مرتبط با مجموعه داده، روی تب Table Data کلیک کنید.
    4. برای دانلود داده ها در یک فایل محلی، روی دکمه دانلود کلیک کنید.
    5. برای حذف مجموعه داده روی دکمه Delete کلیک کنید.