Data-driven styling

میانای FeatureLayer

میانا google.maps.FeatureLayer

میانایی که لایه نقشه حاوی ویژگی‌های FeatureType خاصی را نشان می‌دهد که سبک آن می‌تواند در سمت کارخواه لغو شود یا رویدادهایی به آن پیوست شود.

featureType
نوع: FeatureType
FeatureType مرتبط با این FeatureLayer.
isAvailable
نوع: boolean
اینکه این FeatureLayer دردسترس است یا نه، یعنی اینکه «سبک‌بندی داده‌محور» برای این نقشه دردسترس است یا نه (شناسه نقشه‌ای وجود دارد که از کاشی‌های برداری با این FeatureLayer فعال‌شده در سبک نقشه Google Cloud Console استفاده می‌کند.) اگر این مقدار نادرست باشد (یا نادرست شود)، سبک این FeatureLayer به پیش‌فرض برمی‌گردد و رویدادها راه‌اندازی نمی‌شوند.
BetadatasetId
اختیاری
نوع: string optional
«شناسه مجموعه داده» برای این FeatureLayer. فقط درصورتی وجود دارد که featureType، FeatureType.DATASET باشد.
style
اختیاری
سبک Feature در FeatureLayer. وقتی سبک تنظیم شود، اعمال می‌شود. اگر تابع سبک شما به‌روز شود، باید ویژگی سبک را دوباره تنظیم کنید. FeatureStyleFunction باید نتایج ثابتی را هنگام اعمال روی کاشی‌های نقشه برگرداند و باید برای عملکرد بهینه شود. از توابع ناهمگام پشتیبانی نمی‌شود. اگر از FeatureStyleOptions استفاده کنید، همه ویژگی‌های آن لایه با همان FeatureStyleOptions سبک‌بندی می‌شود. برای برداشتن سبک قبلاً تنظیم‌شده، سبک را روی null تنظیم کنید. اگر این FeatureLayer دردسترس نباشد، تنظیم سبک هیچ کاری انجام نمی‌دهد و خطایی را ثبت می‌کند.
addListener
addListener(eventName, handler)
پارامترها:
  • ‫eventName: string رویداد برگزاری در روز دیگر.
  • handler: Function تابع برای رسیدگی به رویدادها.
مقدار برگشتی: MapsEventListener شنونده رویداد حاصل.
تابع شنونده ارائه‌شده را به نام رویداد ارائه‌شده اضافه می‌کند. شناسه‌ای برای این شنونده برمی‌گرداند که می‌تواند با event.removeListener استفاده شود.
click
function(event)
متغیرهای مستقل:
این رویداد زمانی فعال می‌شود که روی FeatureLayer کلیک شود.
mousemove
function(event)
متغیرهای مستقل:
این رویداد زمانی فعال می‌شود که موشواره کاربر روی FeatureLayer حرکت کند.

ثابت‌های FeatureType

google.maps.FeatureType ثابت‌ها
کتابخانه "maps"

شناسه‌های انواع ویژگی.

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع FeatureTypeString تعریف می‌شوند.

const {FeatureType} = await google.maps.importLibrary("maps");
ADMINISTRATIVE_AREA_LEVEL_1 نهاد مدنی رده اول زیر سطح کشور را نشان می‌دهد.
ADMINISTRATIVE_AREA_LEVEL_2 نشان‌دهنده نهاد مدنی رده دوم زیر سطح کشور است.
COUNTRY نهاد سیاسی ملی را نشان می‌دهد.
BetaDATASET نشان‌دهنده مجموعه داده شخص ثالث است.
LOCALITY نشان‌دهنده نهاد سیاسی شهر یا شهرک ثبت‌شده است.
POSTAL_CODE کد پستی را نشان می‌دهد که برای آدرس‌دهی نامه‌های پستی در کشور استفاده می‌شود. شامل کد پستی می‌شود.
SCHOOL_DISTRICT منطقه آموزشی را نشان می‌دهد.

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

تابعی برای سبک‌دهی به FeatureLayer.

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

میانای FeatureStyleFunctionOptions

میانا google.maps.FeatureStyleFunctionOptions

گزینه‌ها به FeatureStyleFunction منتقل شد.

feature
نوع: Feature
Feature برای سبک‌پردازی به FeatureStyleFunction منتقل شد.

میانای FeatureStyleOptions

میانا google.maps.FeatureStyleOptions

این گزینه‌ها نحوه اصلاح سبک Feature را در نقشه مشخص می‌کنند.

fillColor
اختیاری
نوع: string optional
رشته Hex RGB (مانند «‎#00FF00» برای سبز). فقط برای هندسه‌های چندضلعی اعمال می‌شود.
fillOpacity
اختیاری
نوع: number optional
ماتی پرکننده بین ۰٫۰ و ۱٫۰. فقط برای هندسه‌های چندضلعی اعمال می‌شود.
strokeColor
اختیاری
نوع: string optional
رشته Hex RGB (مانند «‎#00FF00» برای سبز).
strokeOpacity
اختیاری
نوع: number optional
کدری خط بین ۰٫۰ و ۱٫۰. فقط برای هندسه‌های خطی و چندضلعی اعمال می‌شود.
strokeWeight
اختیاری
نوع: number optional
ضخامت خط پیرامونی به پیکسل. فقط برای هندسه‌های خطی و چندضلعی اعمال می‌شود.

رابط ویژگی

میانا google.maps.Feature

میانایی که ویژگی کاشی نقشه بُرداری را نشان می‌دهد. این‌ها ورودی‌های FeatureStyleFunction هستند. مرجع را در شیء Feature خاصی ذخیره نکنید زیرا مرجع پایدار نخواهد بود.

featureType
نوع: FeatureType
FeatureType از این Feature.

PlaceFeature میانجی

google.maps.PlaceFeature interface
extends Feature

میانایی که نشان‌دهنده ویژگی‌ای با شناسه مکان است که شامل ویژگی‌های نوع FeatureType.ADMINISTRATIVE_AREA_LEVEL_1،‏ FeatureType.ADMINISTRATIVE_AREA_LEVEL_2،‏ FeatureType.COUNTRY،‏ FeatureType.LOCALITY،‏ FeatureType.POSTAL_CODE، و FeatureType.SCHOOL_DISTRICT می‌شود.

placeId
نوع: string
از سازمان بالاتر: featureType
fetchPlace
fetchPlace()
پارامترها: هیچ
مقدار برگشتی: Promise<Place>
Place را برای این PlaceFeature واکشی می‌کند. در شیء Place حاصل، ویژگی‌های id و displayName پر خواهند شد. نام نمایشی به زبانی خواهد بود که کاربر نهایی در نقشه می‌بیند. (فیلدهای اضافی را می‌توان متعاقباً ازطریق Place.fetchFields() درخواست کرد، مشروط به فعال‌سازی و صورت‌حساب عادی Places API.) این را از FeatureStyleFunction فراخوانی نکنید زیرا فقط FeatureStyleFunctions همگام پشتیبانی می‌شود. اگر خطایی در واکشی Place وجود داشته باشد، وعده رد می‌شود.

میانای DatasetFeature

google.maps.DatasetFeature interface
extends Feature

میانایی که ویژگی‌ای از «مجموعه داده» را نشان می‌دهد. featureType DatasetFeature همیشه FeatureType.DATASET خواهد بود.

datasetAttributes
نوع: Object<string, string>
نگاشت مقدار کلید مشخصه‌های ویژگی.
datasetId
نوع: string
شناسه مجموعه داده‌ای که این ویژگی به آن تعلق دارد.
از سازمان بالاتر: featureType

میانای FeatureMouseEvent

google.maps.FeatureMouseEvent interface
extends MapMouseEvent

این شیء از رویداد موشواره در FeatureLayer برگردانده شده است.

features
نوع: Array<Feature>
Feature در این رویداد موشواره.
به‌ارث‌رسیده: domEvent، latLng
از سازمان بالاتر: stop