Places Widgets

کلاس BasicPlaceAutocompleteElement

google.maps.places . BasicPlaceAutocompleteElement کلاس google.maps.places . BasicPlaceAutocompleteElement

BasicPlaceAutocompleteElement یک زیر کلاس HTMLElement است که یک مؤلفه UI برای Places Autocomplete API فراهم می کند.

عنصر سفارشی:
<gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-basic-place-autocomplete>

این کلاس HTMLElement را گسترش می دهد.

این کلاس BasicPlaceAutocompleteElementOptions را پیاده سازی می کند.

با فراخوانی const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
BasicPlaceAutocompleteElement	BasicPlaceAutocompleteElement(options) پارامترها: options : BasicPlaceAutocompleteElementOptions

خواص
includedPrimaryTypes	نوع: Array <string> optional شامل نوع مکان اصلی (به عنوان مثال، "رستوران" یا "پمپ بنزین"). یک مکان تنها در صورتی برگردانده می شود که نوع اصلی آن در این لیست گنجانده شده باشد. حداکثر 5 مقدار قابل تعیین است. اگر هیچ نوع مشخصی وجود نداشته باشد، همه انواع Place برگردانده می شوند. ویژگی HTML: <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes	نوع: Array <string> optional فقط شامل نتایج در مناطق مشخص شده، مشخص شده به عنوان حداکثر 15 کد منطقه دو نویسه CLDR. مجموعه خالی نتایج را محدود نمی کند. اگر هر دو locationRestriction و includedRegionCodes تنظیم شده باشند، نتایج در ناحیه تقاطع قرار خواهند گرفت. ویژگی HTML: <gmp-basic-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-basic-place-autocomplete>
locationBias	نوع: LocationBias optional یک مرز نرم یا اشاره برای استفاده در هنگام جستجوی مکان‌ها.
locationRestriction	نوع: LocationRestriction optional محدودیت هایی برای محدود کردن نتایج جستجو.
name	نوع: string optional نامی که برای عنصر ورودی استفاده می شود. برای جزئیات به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name مراجعه کنید. رفتاری مشابه با ویژگی name برای ورودی ها دنبال می کند. توجه داشته باشید که این نامی است که هنگام ارسال فرم استفاده می شود. برای جزئیات بیشتر به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form مراجعه کنید. ویژگی HTML: <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin	نوع: LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional مبدأ محاسبه فاصله. در صورت عدم تعیین فاصله محاسبه نمی شود. ارتفاع، اگر داده شود، در محاسبه استفاده نمی شود. ویژگی HTML: <gmp-basic-place-autocomplete origin="lat,lng"></gmp-basic-place-autocomplete> <gmp-basic-place-autocomplete origin="lat,lng,altitude"></gmp-basic-place-autocomplete>
requestedLanguage	نوع: string optional در صورت امکان، یک شناسه زبان برای زبانی که نتایج باید به آن بازگردانده شوند. ممکن است به نتایج زبان انتخابی رتبه بالاتری داده شود، اما پیشنهادات محدود به این زبان نیست. لیست زبان های پشتیبانی شده را ببینید. ویژگی HTML: <gmp-basic-place-autocomplete requested-language="string"></gmp-basic-place-autocomplete>
requestedRegion	نوع: string optional یک کد منطقه ای که برای قالب بندی نتایج و برای فیلتر کردن نتایج استفاده می شود. این پیشنهادات را به این کشور محدود نمی کند. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی"). ویژگی HTML: <gmp-basic-place-autocomplete requested-region="string"></gmp-basic-place-autocomplete>
unitSystem	نوع: UnitSystem optional سیستم واحدی که برای نمایش فواصل استفاده می شود. اگر مشخص نشده باشد، سیستم واحد توسط requestedRegion تعیین می شود. ویژگی HTML: <gmp-basic-place-autocomplete unit-system="metric"></gmp-basic-place-autocomplete> <gmp-basic-place-autocomplete unit-system="imperial"></gmp-basic-place-autocomplete>

شکاف ها
prediction-item-icon	این اسلات دقیقاً یک عنصر <template> را می پذیرد تا به عنوان نماد نشان داده شده در کنار آیتم پیش بینی نمایش داده شود.

قطعات
prediction-item	موردی در فهرست کشویی پیش بینی ها که نشان دهنده یک پیش بینی واحد است.
prediction-item-icon	نمادی که در سمت چپ هر مورد در لیست پیش بینی ها نمایش داده می شود.
prediction-item-main-text	بخشی از پیش بینی - آیتم که متن اصلی پیش بینی است. برای مکان‌های جغرافیایی، این شامل نام مکانی، مانند «سیدنی» یا نام و شماره خیابان، مانند «خیابان 10 کینگ» است. به طور پیش‌فرض، پیش‌بینی آیتم-متن-متن سیاه رنگ است. اگر متن اضافی در پیش‌بینی آیتم وجود داشته باشد، خارج از پیش‌بینی-آیتم-متن-اصلی است و سبک خود را از پیش‌بینی-آیتم به ارث می‌برد. به طور پیش فرض خاکستری رنگ است. متن اضافی معمولاً یک آدرس است.
prediction-item-match	بخشی از پیش بینی برگشتی که با ورودی کاربر مطابقت دارد. به طور پیش فرض، این متن مطابق با متن پررنگ برجسته می شود. توجه داشته باشید که متن تطبیق داده شده ممکن است در هر نقطه ای از پیش بینی مورد باشد. لزوماً بخشی از پیش‌بینی-متن-متن-اصلی نیست.
prediction-item-selected	موردی که کاربر از طریق صفحه کلید به آن می رود. توجه: آیتم های انتخاب شده هم تحت تاثیر سبک های این قسمت و هم سبک های قسمت پیش بینی-آیتم قرار می گیرند.
prediction-list	عنصر بصری حاوی لیستی از پیش بینی های ارائه شده توسط سرویس تکمیل خودکار مکان. این لیست به عنوان یک لیست کشویی در زیر PlaceAutocompleteElement ظاهر می شود.

ویژگی های CSS
background-color	رنگ پس‌زمینه عنصر را لغو می‌کند.
border	مرز عنصر را لغو می کند.
border-radius	شعاع مرزی عنصر را لغو می کند.
color-scheme	نشان می دهد که این عنصر در کدام طرح رنگی می تواند رندر شود. برای جزئیات بیشتر به مستندات color-scheme مراجعه کنید. پیش‌فرض‌های color-scheme: light dark .

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رویدادها
gmp-error	function(errorEvent) استدلال ها: errorEvent : Event این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-select	function(placeSelectEvent) استدلال ها: placeSelectEvent : PlaceSelectEvent این رویداد زمانی فعال می‌شود که کاربر پیش‌بینی مکان را انتخاب کند. حاوی یک شی مکان است.

رابط BasicPlaceAutocompleteElementOptions

google.maps.places . BasicPlaceAutocompleteElementOptions رابط google.maps.places . BasicPlaceAutocompleteElementOptions

گزینه هایی برای ساخت یک BasicPlaceAutocompleteElement.

خواص
includedPrimaryTypes optional	نوع: Array <string> optional
includedRegionCodes optional	نوع: Array <string> optional
locationBias optional	نوع: LocationBias optional
locationRestriction optional	نوع: LocationRestriction optional
name optional	نوع: string optional
origin optional	نوع: LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional
requestedLanguage optional	نوع: string optional
requestedRegion optional	نوع: string optional
unitSystem optional	نوع: UnitSystem optional

کلاس PlaceAutocompleteElement

google.maps.places . PlaceAutocompleteElement کلاس google.maps.places . PlaceAutocompleteElement

PlaceAutocompleteElement یک زیر کلاس HTMLElement است که یک مؤلفه UI برای Places Autocomplete API فراهم می کند.

PlaceAutocompleteElement به طور خودکار از AutocompleteSessionToken به صورت داخلی برای گروه بندی مراحل پرس و جو و انتخاب جستجوی تکمیل خودکار کاربر استفاده می کند.

اولین تماس با Place.fetchFields در یک Place که توسط PlacePrediction.toPlace برگردانده شده است به طور خودکار شامل نشانه جلسه مورد استفاده برای واکشی PlacePrediction می شود.

برای جزئیات بیشتر در مورد نحوه عملکرد جلسات، https://developers.google.com/maps/documentation/places/web-service/place-session-tokens را ببینید.

عنصر سفارشی:
<gmp-place-autocomplete included-primary-types="type1 type2 type3..." included-region-codes="c1 c2 c3..." name="string" origin="lat,lng" requested-language="string" requested-region="string" unit-system="metric"></gmp-place-autocomplete>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceAutocompleteElementOptions پیاده سازی می کند.

با فراخوانی const {PlaceAutocompleteElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceAutocompleteElement	PlaceAutocompleteElement(options) پارامترها: options : PlaceAutocompleteElementOptions

خواص
includedPrimaryTypes	نوع: Array <string> optional شامل نوع مکان اصلی (به عنوان مثال، "رستوران" یا "پمپ بنزین"). یک مکان تنها در صورتی برگردانده می شود که نوع اصلی آن در این لیست گنجانده شده باشد. حداکثر 5 مقدار قابل تعیین است. اگر هیچ نوع مشخصی وجود نداشته باشد، همه انواع Place برگردانده می شوند. ویژگی HTML: <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes	نوع: Array <string> optional فقط شامل نتایج در مناطق مشخص شده، مشخص شده به عنوان حداکثر 15 کد منطقه دو نویسه CLDR. مجموعه خالی نتایج را محدود نمی کند. اگر هر دو locationRestriction و includedRegionCodes تنظیم شده باشند، نتایج در ناحیه تقاطع قرار خواهند گرفت. ویژگی HTML: <gmp-place-autocomplete included-region-codes="c1 c2 c3..."></gmp-place-autocomplete>
locationBias	نوع: LocationBias optional یک مرز نرم یا اشاره برای استفاده در هنگام جستجوی مکان‌ها.
locationRestriction	نوع: LocationRestriction optional محدودیت هایی برای محدود کردن نتایج جستجو.
name	نوع: string optional نامی که برای عنصر ورودی استفاده می شود. برای جزئیات به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name مراجعه کنید. رفتاری مشابه با ویژگی name برای ورودی ها دنبال می کند. توجه داشته باشید که این نامی است که هنگام ارسال فرم استفاده می شود. برای جزئیات بیشتر به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form مراجعه کنید. ویژگی HTML: <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin	نوع: LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional مبدأ محاسبه فاصله. در صورت عدم تعیین فاصله محاسبه نمی شود. ارتفاع، اگر داده شود، در محاسبه استفاده نمی شود. ویژگی HTML: <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete> <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
requestedLanguage	نوع: string optional در صورت امکان، یک شناسه زبان برای زبانی که نتایج باید به آن بازگردانده شوند. ممکن است به نتایج زبان انتخابی رتبه بالاتری داده شود، اما پیشنهادات محدود به این زبان نیست. لیست زبان های پشتیبانی شده را ببینید. ویژگی HTML: <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion	نوع: string optional یک کد منطقه ای که برای قالب بندی نتایج و برای فیلتر کردن نتایج استفاده می شود. این پیشنهادات را به این کشور محدود نمی کند. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی"). ویژگی HTML: <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
unitSystem	نوع: UnitSystem optional سیستم واحدی که برای نمایش فواصل استفاده می شود. اگر مشخص نشده باشد، سیستم واحد توسط requestedRegion تعیین می شود. ویژگی HTML: <gmp-place-autocomplete unit-system="metric"></gmp-place-autocomplete> <gmp-place-autocomplete unit-system="imperial"></gmp-place-autocomplete>

قطعات
prediction-item	موردی در فهرست کشویی پیش بینی ها که نشان دهنده یک پیش بینی واحد است.
prediction-item-icon	نمادی که در سمت چپ هر مورد در لیست پیش بینی ها نمایش داده می شود.
prediction-item-main-text	بخشی از پیش بینی - آیتم که متن اصلی پیش بینی است. برای مکان‌های جغرافیایی، این شامل نام مکانی، مانند «سیدنی» یا نام و شماره خیابان، مانند «خیابان 10 کینگ» است. به طور پیش‌فرض، پیش‌بینی آیتم-متن-متن سیاه رنگ است. اگر متن اضافی در پیش‌بینی آیتم وجود داشته باشد، خارج از پیش‌بینی-آیتم-متن-اصلی است و سبک خود را از پیش‌بینی-آیتم به ارث می‌برد. به طور پیش فرض خاکستری رنگ است. متن اضافی معمولاً یک آدرس است.
prediction-item-match	بخشی از پیش بینی برگشتی که با ورودی کاربر مطابقت دارد. به طور پیش فرض، این متن مطابق با متن پررنگ برجسته می شود. توجه داشته باشید که متن تطبیق داده شده ممکن است در هر نقطه ای از پیش بینی مورد باشد. لزوماً بخشی از پیش‌بینی-متن-متن-اصلی نیست.
prediction-item-selected	موردی که کاربر از طریق صفحه کلید به آن می رود. توجه: آیتم های انتخاب شده هم تحت تاثیر سبک های این قسمت و هم سبک های قسمت پیش بینی-آیتم قرار می گیرند.
prediction-list	عنصر بصری حاوی لیستی از پیش بینی های ارائه شده توسط سرویس تکمیل خودکار مکان. این لیست به عنوان یک لیست کشویی در زیر PlaceAutocompleteElement ظاهر می شود.

ویژگی های CSS
background-color	رنگ پس‌زمینه عنصر را لغو می‌کند.
border	مرز عنصر را لغو می کند.
border-radius	شعاع مرزی عنصر را لغو می کند.
color-scheme	نشان می دهد که این عنصر در کدام طرح رنگی می تواند رندر شود. برای جزئیات بیشتر به مستندات color-scheme مراجعه کنید. پیش‌فرض‌های color-scheme: light dark .

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رویدادها
gmp-error	function(errorEvent) استدلال ها: errorEvent : Event این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-select	function(placePredictionSelectEvent) استدلال ها: placePredictionSelectEvent : PlacePredictionSelectEvent این رویداد زمانی فعال می‌شود که کاربر پیش‌بینی مکان را انتخاب کند. شامل یک شی PlacePrediction است که می تواند به یک شی Place تبدیل شود.

رابط PlaceAutocompleteElementOptions

google.maps.places . PlaceAutocompleteElementOptions رابط google.maps.places . PlaceAutocompleteElementOptions

گزینه هایی برای ساخت PlaceAutocompleteElement. برای توضیح هر ویژگی، به ویژگی همنام در کلاس PlaceAutocompleteElement مراجعه کنید.

خواص
includedPrimaryTypes optional	نوع: Array <string> optional
includedRegionCodes optional	نوع: Array <string> optional
locationBias optional	نوع: LocationBias optional
locationRestriction optional	نوع: LocationRestriction optional
name optional	نوع: string optional
origin optional	نوع: LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional
requestedLanguage optional	نوع: string optional
requestedRegion optional	نوع: string optional
unitSystem optional	نوع: UnitSystem optional

کلاس PlacePredictionSelectEvent

google.maps.places . PlacePredictionSelectEvent کلاس google.maps.places . PlacePredictionSelectEvent

این رویداد پس از انتخاب یک مورد پیش بینی توسط کاربر با PlaceAutocompleteElement ایجاد می شود. با event.placePrediction به انتخاب دسترسی پیدا کنید.

با فراخوانی PlacePrediction.toPlace placePrediction را به یک Place تبدیل کنید.

این کلاس Event را گسترش می دهد.

با فراخوانی const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

خواص
placePrediction	نوع: PlacePrediction با فراخوانی PlacePrediction.toPlace آن را به یک Place تبدیل کنید.

کلاس PlaceAutocompleteRequestErrorEvent

google.maps.places . PlaceAutocompleteRequestErrorEvent کلاس google.maps.places . PlaceAutocompleteRequestErrorEvent

منسوخ شده: رویداد gmp-requesterror همچنان در کانال بتا فعال می شود، اما در آلفا یا در زمان انتشار فعال نخواهد شد. برای اهداف انتقال، به گوش دادن به رویداد gmp-requesterror ادامه دهید، اما همچنین یک شنونده رویداد برای رویداد gmp-error اضافه کنید که یک شی Event را برمی گرداند.

توجه: فقط در کانال v=beta موجود است.

این رویداد توسط PlaceAutocompleteElement زمانی که مشکلی در درخواست شبکه وجود دارد منتشر می شود.

این کلاس Event را گسترش می دهد.

با فراخوانی const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

کلاس PlaceContextualElement

google.maps.places . PlaceContextualElement کلاس google.maps.places . PlaceContextualElement

توجه: فقط در کانال v=alpha موجود است.

ویجتی که از نشانه زمینه برای نمایش نمای متنی پاسخ Grounding با Google Maps استفاده می کند.

عنصر سفارشی:
<gmp-place-contextual context-token="string"></gmp-place-contextual>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceContextualElementOptions پیاده سازی می کند.

با فراخوانی const {PlaceContextualElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceContextualElement	PlaceContextualElement([options]) پارامترها: options : PlaceContextualElementOptions optional

خواص
contextToken	نوع: string optional نشانه زمینه. ویژگی HTML: <gmp-place-contextual context-token="string"></gmp-place-contextual>

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceContextualElementOptions

google.maps.places . PlaceContextualElementOptions رابط google.maps.places . PlaceContextualElementOptions

توجه: فقط در کانال v=alpha موجود است.

گزینه‌های PlaceContextualElement .

خواص
contextToken optional	نوع: string optional نشانه زمینه ارائه شده توسط پاسخ Grounding with Google Maps.

کلاس PlaceContextualListConfigElement

google.maps.places . PlaceContextualListConfigElement کلاس google.maps.places . PlaceContextualListConfigElement

توجه: فقط در کانال v=alpha موجود است.

یک عنصر HTML که گزینه‌هایی را برای نمای فهرست Place Contextual Element پیکربندی می‌کند.

عنصر سفارشی:
<gmp-place-contextual-list-config layout="compact" map-hidden map-mode="none"></gmp-place-contextual-list-config>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceContextualListConfigElementOptions را پیاده سازی می کند.

با فراخوانی const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceContextualListConfigElement	PlaceContextualListConfigElement([options]) پارامترها: options : PlaceContextualListConfigElementOptions optional

خواص
layout	نوع: PlaceContextualListLayout optional طرح. ویژگی HTML: <gmp-place-contextual-list-config layout="compact"></gmp-place-contextual-list-config> <gmp-place-contextual-list-config layout="vertical"></gmp-place-contextual-list-config>
mapHidden	نوع: boolean optional این که آیا نقشه پنهان است. ویژگی HTML: <gmp-place-contextual-list-config map-hidden></gmp-place-contextual-list-config>
mapMode	نوع: PlaceContextualListMapMode optional حالت نقشه مورد استفاده در Place Contextual Element برای فهرستی از مکان‌ها. ویژگی HTML: <gmp-place-contextual-list-config map-mode="none"></gmp-place-contextual-list-config> <gmp-place-contextual-list-config map-mode="roadmap"></gmp-place-contextual-list-config> <gmp-place-contextual-list-config map-mode="hybrid"></gmp-place-contextual-list-config>

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceContextualListConfigElementOptions

google.maps.places . PlaceContextualListConfigElementOptions رابط google.maps.places . PlaceContextualListConfigElementOptions

توجه: فقط در کانال v=alpha موجود است.

گزینه های PlaceContextualListConfigElement.

خواص
layout optional	نوع: PlaceContextualListLayout optional پیش فرض: PlaceContextualListLayout.VERTICAL طرح.
mapHidden optional	نوع: boolean optional پیش فرض: false درست است اگر نقشه باید پنهان شود.
mapMode optional	نوع: PlaceContextualListMapMode optional پیش فرض: PlaceContextualListMapMode.ROADMAP حالت نقشه مورد استفاده در Place Contextual Element برای فهرستی از مکان‌ها.

ثابت های PlaceContextualListLayout

google.maps.places . PlaceContextualListLayout ثابت های google.maps.places . PlaceContextualListLayout

توجه: فقط در کانال v=alpha موجود است.

فهرست طرح‌بندی‌هایی که Place Contextual Element برای نمای فهرست پشتیبانی می‌کند.

با فراخوانی const {PlaceContextualListLayout} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

ثابت ها
COMPACT	طرح‌بندی فهرست فشرده: موارد فهرست به‌عنوان پیوندهایی در یک خط، با سرریزها در یک فهرست کشویی ارائه می‌شوند.
VERTICAL	طرح بندی لیست عمودی: موارد لیست به صورت کارت در یک لیست عمودی ارائه می شوند.

ثابت های PlaceContextualListMapMode

google.maps.places . PlaceContextualListMapMode ثابت های google.maps.places . PlaceContextualListMapMode

توجه: فقط در کانال v=alpha موجود است.

حالت نقشه مورد استفاده در Place Contextual Element برای فهرستی از مکان‌ها.

با فراخوانی const {PlaceContextualListMapMode} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

ثابت ها
HYBRID	یک لایه شفاف از خیابان های اصلی در ماهواره، یا تصاویر واقع گرایانه به صورت سه بعدی.
NONE	بدون نقشه
ROADMAP	یک نقشه خیابان دو بعدی معمولی.

کلاس PlaceDetailsElement

google.maps.places . PlaceDetailsElement کلاس google.maps.places . PlaceDetailsElement

جزئیات یک مکان را در یک طرح کامل نمایش می دهد. یک PlaceDetailsPlaceRequestElement یا PlaceDetailsLocationRequestElement را اضافه کنید تا مکانی را که باید ارائه شود را مشخص کنید. یک PlaceContentConfigElement ، PlaceStandardContentElement ، یا PlaceAllContentElement را اضافه کنید تا مشخص کنید کدام محتوا باید ارائه شود.

مثال:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details> 

برای استفاده از این عنصر، Places UI Kit API را برای پروژه خود در کنسول Google Cloud فعال کنید.

عنصر سفارشی:
<gmp-place-details></gmp-place-details>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceDetailsElementOptions پیاده سازی می کند.

با فراخوانی const {PlaceDetailsElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceDetailsElement	PlaceDetailsElement([options]) پارامترها: options : PlaceDetailsElementOptions optional

خواص
place	نوع: Place optional فقط بخوانید. شی مکان حاوی شناسه، مکان، و نمای مکان رندر شده فعلی است.

ویژگی های CSS
--gmp-button-border-color	رنگ حاشیه دکمه "Open in Maps".
--gmp-button-border-radius	شعاع مرزی دکمه «باز کردن در نقشه‌ها».
--gmp-button-border-width	عرض حاشیه دکمه "باز کردن در نقشه ها".
--gmp-collage-border-radius-outer	شعاع مرزی گوشه های بیرونی کلاژ رسانه.
--gmp-dialog-border-radius	شعاع مرزی گفتگوی افشای Google Maps.
--gmp-mat-color-disabled-surface	رنگ سطح در نظر گرفته شده برای انتقال حالت های غیر فعال یا عدم وجود. برای ستاره های نقد خالی استفاده می شود.
--gmp-mat-color-info	رنگ عناصر UI با احساسات اطلاعاتی. برای نماد صندلی چرخدار استفاده می شود.
--gmp-mat-color-negative	رنگ عناصر رابط کاربری با احساسات منفی. برای متن "بسته" در وضعیت اکنون باز استفاده می شود.
--gmp-mat-color-neutral-container	رنگ ظرف برای عناصر UI پر شده خنثی. برای مکان‌نماهای تصویر و نشان تاریخ منتشر شده مروری استفاده می‌شود.
--gmp-mat-color-on-neutral-container	رنگ متن و نمادها در برابر رنگ ظرف خنثی. برای بررسی نشان تاریخ انتشار و نشان در دسترس بودن شارژر EV در صورت در دسترس نبودن استفاده می شود.
--gmp-mat-color-on-positive-container	رنگ متون و نمادها در برابر رنگ ظرف مثبت. در صورت موجود بودن برای نشان در دسترس بودن شارژر EV استفاده می شود.
--gmp-mat-color-on-secondary-container	رنگ متن و نمادها در برابر رنگ ظرف ثانویه. برای متن و نمادهای روی دکمه "باز کردن در نقشه ها" استفاده می شود.
--gmp-mat-color-on-surface	رنگ برای متن و نمادها در برابر هر رنگ سطحی. برای متن معمولی استفاده می شود.
--gmp-mat-color-on-surface-variant	رنگ با تاکید کمتر برای متن و نمادها در برابر هر رنگ سطحی. برای متنی که تاکید کمتری دارد استفاده می شود.
--gmp-mat-color-outline-decorative	رنگ طرح عناصر غیر تعاملی برای حاشیه عنصر استفاده می شود.
--gmp-mat-color-positive	رنگ عناصر رابط کاربری با احساسات مثبت. برای متن "Open" در وضعیت open now استفاده می شود.
--gmp-mat-color-positive-container	رنگ ظرف برای عناصر UI که احساسات مثبت را منتقل می کند. در صورت موجود بودن برای نشان در دسترس بودن شارژر EV استفاده می شود.
--gmp-mat-color-primary	رنگ متن تعاملی و نمادها در برابر رنگ سطح. برای تعداد بازبینی، پیوندها در گفتگوی افشای نقشه‌های Google، پیوند وب‌سایت، نمادها در برگه نمای کلی، و (موشواره / فوکوس / رنگ متن) روی عنوان نوار برگه استفاده می‌شود.
--gmp-mat-color-secondary-container	رنگ پرکننده کمتر در برابر سطح، برای اجزای مغلوب مانند دکمه های تونال. برای پس‌زمینه دکمه «باز کردن در نقشه‌ها» استفاده می‌شود.
--gmp-mat-color-surface	رنگ برای پس زمینه برای پس‌زمینه عنصر و گفتگوی افشای نقشه‌های Google استفاده می‌شود.
--gmp-mat-font-body-medium	برای آدرس مکان، رتبه‌بندی، نوع، قیمت، وضعیت اکنون باز، ساعات کاری، مرور، شماره تلفن، وب‌سایت، کد بعلاوه، ویژگی‌های برتر و متن اصلی در گفتگوی افشای Google Maps استفاده می‌شود.
--gmp-mat-font-body-small	برای متن اصلی در لیست ویژگی‌ها در برگه «درباره» استفاده می‌شود.
--gmp-mat-font-display-small	برای نام مکان و متن برای هر عنوان ویژگی در برگه "درباره" استفاده می شود.
--gmp-mat-font-family	خانواده فونت پایه برای تمام متن ها استفاده می شود.
--gmp-mat-font-headline-medium	برای عنوان متن در گفتگوی افشای نقشه های Google استفاده می شود.
--gmp-mat-font-label-large	برای عناوین برگه‌ها، دکمه «باز کردن در نقشه‌ها»، متن انتساب بازبین در گالری عکس، متن انتساب بازبین در بخش نظرات، و پیوندها در گفتگوی افشای Google Maps استفاده می‌شود.
--gmp-mat-font-label-medium	برای نشان شمارش عکس‌ها و بازبینی تاریخ منتشر شده استفاده می‌شود.
--gmp-mat-font-title-small	برای عنوان هر بخش در برگه "درباره" استفاده می شود.
--gmp-mat-spacing-extra-large	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-extra-small	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-large	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-medium	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-small	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-two-extra-large	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-star-rating-color	رنگ ستاره های پر شده در رتبه بندی.
background-color	رنگ پس‌زمینه عنصر را لغو می‌کند.
border	مرز عنصر را لغو می کند.
border-radius	شعاع مرزی عنصر را لغو می کند.
color-scheme	نشان می دهد که این عنصر در کدام طرح رنگی می تواند رندر شود. برای جزئیات بیشتر به مستندات color-scheme مراجعه کنید. پیش‌فرض‌های color-scheme: light dark .
font-size	تمام متن ها و نمادهای موجود در عنصر را که به صورت داخلی در ems تعریف شده اند، مقیاس می کند. پیش‌فرض 16px است.

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رویدادها
gmp-error	function(event) استدلال ها: event : Event این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-load	function(event) استدلال ها: event : Event این رویداد زمانی فعال می شود که عنصر محتوای خود را بارگذاری و ارائه می کند. این رویداد حباب نمی کند.

رابط PlaceDetailsElementOptions

google.maps.places . PlaceDetailsElementOptions رابط google.maps.places . PlaceDetailsElementOptions

گزینه‌های PlaceDetailsElement .

کلاس PlaceDetailsCompactElement

google.maps.places . PlaceDetailsCompactElement کلاس google.maps.places . PlaceDetailsCompactElement

جزئیات یک مکان را در یک طرح فشرده نمایش می دهد. یک PlaceDetailsPlaceRequestElement یا PlaceDetailsLocationRequestElement را اضافه کنید تا مکانی را که باید ارائه شود را مشخص کنید. یک PlaceContentConfigElement ، PlaceStandardContentElement ، یا PlaceAllContentElement را اضافه کنید تا مشخص کنید کدام محتوا باید ارائه شود.

مثال:

 <gmp-place-details-compact>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-details-compact> 

برای استفاده از این عنصر، Places UI Kit API را برای پروژه خود در کنسول Google Cloud فعال کنید.

عنصر سفارشی:
<gmp-place-details-compact orientation="vertical" truncation-preferred></gmp-place-details-compact>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceDetailsCompactElementOptions پیاده سازی می کند.

با فراخوانی const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceDetailsCompactElement	PlaceDetailsCompactElement([options]) پارامترها: options : PlaceDetailsCompactElementOptions optional

خواص
orientation	نوع: PlaceDetailsOrientation optional پیش فرض: PlaceDetailsOrientation.VERTICAL نوع جهت گیری (عمودی یا افقی) عنصر. ویژگی HTML: <gmp-place-details-compact orientation="vertical"></gmp-place-details-compact> <gmp-place-details-compact orientation="horizontal"></gmp-place-details-compact>
place	نوع: Place optional فقط بخوانید. شی مکان حاوی شناسه، مکان، و نمای مکان رندر شده فعلی است.
truncationPreferred	نوع: boolean پیش فرض: false اگر درست است، نام مکان و آدرس را کوتاه می کند تا به جای بسته بندی در یک خط قرار گیرد. ویژگی HTML: <gmp-place-details-compact truncation-preferred></gmp-place-details-compact>

ویژگی های CSS
--gmp-button-border-color	رنگ حاشیه دکمه "Open in Maps".
--gmp-button-border-radius	شعاع مرزی دکمه «باز کردن در نقشه‌ها».
--gmp-button-border-width	عرض حاشیه دکمه "باز کردن در نقشه ها".
--gmp-dialog-border-radius	شعاع مرزی گفتگوی افشای Google Maps.
--gmp-mat-color-info	رنگ عناصر UI با احساسات اطلاعاتی. برای نماد صندلی چرخدار استفاده می شود.
--gmp-mat-color-negative	رنگ عناصر رابط کاربری با احساسات منفی. برای متن "بسته" در وضعیت اکنون باز استفاده می شود.
--gmp-mat-color-neutral-container	رنگ ظرف برای عناصر UI پر شده خنثی. برای مکان‌نماهای تصویر استفاده می‌شود.
--gmp-mat-color-on-secondary-container	رنگ متن و نمادها در برابر رنگ ظرف ثانویه. برای متن و نمادهای روی دکمه "باز کردن در نقشه ها" استفاده می شود.
--gmp-mat-color-on-surface	رنگ برای متن و نمادها در برابر هر رنگ سطحی. برای متن معمولی استفاده می شود.
--gmp-mat-color-on-surface-variant	رنگ با تاکید کمتر برای متن و نمادها در برابر هر رنگ سطحی. برای متن هایی با تاکید کمتر استفاده می شود.
--gmp-mat-color-outline-decorative	رنگ طرح عناصر غیر تعاملی برای حاشیه عنصر استفاده می شود.
--gmp-mat-color-positive	رنگ عناصر رابط کاربری با احساسات مثبت. برای متن "Open" در وضعیت open now استفاده می شود.
--gmp-mat-color-primary	رنگ متن تعاملی و نمادها در برابر رنگ سطح. برای تعداد بازبینی و همچنین پیوندها در گفتگوی افشای Google Maps استفاده می‌شود.
--gmp-mat-color-secondary-container	رنگ پرکننده کمتر در برابر سطح، برای اجزای مغلوب مانند دکمه های تونال. برای پس‌زمینه دکمه «باز کردن در نقشه‌ها» استفاده می‌شود.
--gmp-mat-color-surface	رنگ برای پس زمینه برای پس‌زمینه عنصر و گفتگوی افشای نقشه‌های Google استفاده می‌شود.
--gmp-mat-font-body-medium	برای متن اصلی در گفتگوی افشای Google Maps استفاده می شود.
--gmp-mat-font-body-small	برای آدرس مکان، رتبه بندی، نوع، قیمت و وضعیت اکنون باز استفاده می شود.
--gmp-mat-font-family	خانواده فونت پایه برای تمام متن ها استفاده می شود.
--gmp-mat-font-headline-medium	برای عنوان متن در گفتگوی افشای نقشه های Google استفاده می شود.
--gmp-mat-font-label-large	برای دکمه «باز کردن در نقشه‌ها» و همچنین پیوندهای موجود در گفتگوی افشای Google Maps و متن ذکر منبع در گالری عکس استفاده می‌شود.
--gmp-mat-font-label-medium	برای نشان تعداد عکس ها استفاده می شود.
--gmp-mat-font-title-small	برای نام مکان استفاده می شود.
--gmp-mat-spacing-extra-small	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-large	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-medium	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-small	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-star-rating-color	رنگ ستاره های پر شده در رتبه بندی.
--gmp-thumbnail-border-radius	شعاع مرزی تصویر کوچک مکان.
background-color	رنگ پس‌زمینه عنصر را لغو می‌کند.
border	مرز عنصر را لغو می کند.
border-radius	شعاع مرزی عنصر را لغو می کند.
color-scheme	نشان می دهد که این عنصر در کدام طرح رنگی می تواند رندر شود. برای جزئیات بیشتر به مستندات color-scheme مراجعه کنید. پیش‌فرض‌های color-scheme: light dark .
font-size	تمام متن ها و نمادهای موجود در عنصر را که به صورت داخلی در ems تعریف شده اند، مقیاس می کند. پیش‌فرض 16px است.

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رویدادها
gmp-error	function(event) استدلال ها: event : Event این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-load	function(event) استدلال ها: event : Event این رویداد زمانی فعال می شود که عنصر محتوای خود را بارگذاری و ارائه می کند. این رویداد حباب نمی کند.

رابط PlaceDetailsCompactElementOptions

google.maps.places . PlaceDetailsCompactElementOptions رابط google.maps.places . PlaceDetailsCompactElementOptions

گزینه‌هایی برای PlaceDetailsCompactElement .

خواص
orientation optional	نوع: PlaceDetailsOrientation optional PlaceDetailsCompactElement.orientation را ببینید.
truncationPreferred optional	نوع: boolean optional PlaceDetailsCompactElement.truncationPreferred را ببینید.

ثابت مکانDetailsOrientation

google.maps.places . PlaceDetailsOrientation ثابت google.maps.places . PlaceDetailsOrientation

انواع جهت برای PlaceDetailsCompactElement .

با فراخوانی const {PlaceDetailsOrientation} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

ثابت ها
HORIZONTAL	جهت گیری افقی.
VERTICAL	جهت گیری عمودی

کلاس PlaceDetailsPlaceRequestElement

google.maps.places . PlaceDetailsPlaceRequestElement کلاس google.maps.places . PlaceDetailsPlaceRequestElement

یک PlaceDetailsCompactElement یا PlaceDetailsElement را برای بارگیری داده ها بر اساس یک شی مکان، شناسه یا نام منبع پیکربندی می کند. این عنصر را به عنوان فرزند PlaceDetailsCompactElement یا PlaceDetailsElement اضافه کنید تا داده‌ها را برای مکان مشخص شده بارگیری کنید. به عنوان مثال:

 <gmp-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
 </gmp-place-details> 

عنصر سفارشی:
<gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceDetailsPlaceRequestElementOptions را پیاده سازی می کند.

با فراخوانی const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceDetailsPlaceRequestElement	PlaceDetailsPlaceRequestElement([options]) پارامترها: options : PlaceDetailsPlaceRequestElementOptions optional

خواص
place	نوع: Place optional پیش فرض: null شی مکان، شناسه یا نام منبع برای ارائه جزئیات در عنصر Place Details Compact. این ویژگی به عنوان یک نام منبع به ویژگی منعکس می شود. ویژگی HTML: <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceDetailsPlaceRequestElementOptions

google.maps.places . PlaceDetailsPlaceRequestElementOptions رابط google.maps.places . PlaceDetailsPlaceRequestElementOptions

گزینه‌های PlaceDetailsPlaceRequestElement .

خواص
place optional	نوع: Place |string optional PlaceDetailsPlaceRequestElement.place را ببینید

کلاس PlaceDetailsLocationRequestElement

google.maps.places . PlaceDetailsLocationRequestElement کلاس google.maps.places . PlaceDetailsLocationRequestElement

یک PlaceDetailsCompactElement یا PlaceDetailsElement را برای بارگیری داده ها بر اساس یک مکان پیکربندی می کند. این عنصر را به عنوان فرزند PlaceDetailsCompactElement یا PlaceDetailsElement اضافه کنید تا داده ها را برای مکان مشخص شده بارگیری کنید. به عنوان مثال:

 <gmp-place-details>
   <gmp-place-details-location-request
     location="37.6207665,-122.4284806"
   ></gmp-place-details-location-request>
 </gmp-place-details> 

عنصر سفارشی:
<gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceDetailsLocationRequestElementOptions را پیاده سازی می کند.

با فراخوانی const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceDetailsLocationRequestElement	PlaceDetailsLocationRequestElement([options]) پارامترها: options : PlaceDetailsLocationRequestElementOptions optional

خواص
location	نوع: LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional پیش فرض: null مکانی برای ارائه جزئیات در عنصر Place Details. به LatLngAltitude عادی می شود. ویژگی HTML: <gmp-place-details-location-request location="lat,lng"></gmp-place-details-location-request>

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceDetailsLocationRequestElementOptions

google.maps.places . PlaceDetailsLocationRequestElementOptions رابط google.maps.places . PlaceDetailsLocationRequestElementOptions

گزینه‌های PlaceDetailsLocationRequestElement .

خواص
location optional	نوع: LatLng | LatLngLiteral | LatLngAltitude | LatLngAltitudeLiteral optional مکانی برای ارائه مکان برای.

کلاس PlaceSearchElement

google.maps.places . PlaceSearchElement کلاس google.maps.places . PlaceSearchElement

نتایج جستجوی مکان را در یک لیست نمایش می دهد. برای مشخص کردن درخواست ارائه نتایج، یک PlaceTextSearchRequestElement یا PlaceNearbySearchRequestElement اضافه کنید. یک PlaceContentConfigElement ، PlaceStandardContentElement ، یا PlaceAllContentElement را اضافه کنید تا مشخص کنید کدام محتوا باید ارائه شود.

مثال:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search> 

برای استفاده از عنصر جستجوی مکان، API کیت رابط کاربری Places را برای پروژه خود در کنسول Google Cloud فعال کنید.

عنصر سفارشی:
<gmp-place-search attribution-position="top" orientation="vertical" selectable truncation-preferred></gmp-place-search>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceSearchElementOptions پیاده سازی می کند.

با فراخوانی const {PlaceSearchElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceSearchElement	PlaceSearchElement([options]) پارامترها: options : PlaceSearchElementOptions optional

خواص
attributionPosition	نوع: PlaceSearchAttributionPosition optional پیش فرض: PlaceSearchAttributionPosition.TOP موقعیت نشان انتساب و دکمه افشای قانونی. ویژگی HTML: <gmp-place-search attribution-position="top"></gmp-place-search> <gmp-place-search attribution-position="bottom"></gmp-place-search>
orientation	نوع: PlaceSearchOrientation optional پیش فرض: PlaceSearchOrientation.VERTICAL نوع جهت گیری (عمودی یا افقی) عنصر. ویژگی HTML: <gmp-place-search orientation="vertical"></gmp-place-search> <gmp-place-search orientation="horizontal"></gmp-place-search>
places	نوع: Array < Place > فقط بخوانید. آرایه از اشیاء Place حاوی شناسه‌ها، مکان‌ها و درگاه‌های نمایش مکان‌های ارائه‌شده در حال حاضر.
selectable	نوع: boolean optional پیش فرض: false آیا موارد فهرست قابل انتخاب هستند یا نه. اگر درست باشد، آیتم‌های فهرست دکمه‌هایی خواهند بود که در صورت کلیک کردن، رویداد gmp-select را ارسال می‌کنند. پیمایش و انتخاب صفحه کلید قابل دسترس نیز پشتیبانی می شود. ویژگی HTML: <gmp-place-search selectable></gmp-place-search>
truncationPreferred	نوع: boolean optional پیش فرض: false اگر درست باشد، خطوط خاصی از محتوا را کوتاه می کند تا به جای بسته بندی در یک خط قرار گیرد. ویژگی HTML: <gmp-place-search truncation-preferred></gmp-place-search>

ویژگی های CSS
--gmp-button-border-color	رنگ حاشیه برای دکمه "باز کردن در نقشه ها".
--gmp-button-border-radius	شعاع حاشیه برای دکمه "باز کردن در نقشه ها".
--gmp-button-border-width	عرض حاشیه برای دکمه "باز کردن در نقشه ها".
--gmp-card-border-radius	شعاع مرزی برای کارت های مکان.
--gmp-dialog-border-radius	شعاع حاشیه برای گفتگوی افشای Google Maps.
--gmp-mat-color-info	رنگ عناصر UI با احساسات اطلاعاتی. برای نماد ورودی قابل دسترسی استفاده می شود.
--gmp-mat-color-negative	رنگ عناصر رابط کاربری با احساسات منفی. برای برچسب "بسته" برای ساعات کاری یک مکان استفاده می شود.
--gmp-mat-color-neutral-container	رنگ ظرف برای عناصر UI پر شده خنثی. برای بررسی نشان‌های تاریخ و بارگیری شکل‌های مکان‌نما استفاده می‌شود.
--gmp-mat-color-on-neutral-container	رنگ متن و نمادها در یک ظرف خنثی. برای متن تاریخ بررسی و متن خطای بارگذاری استفاده می شود.
--gmp-mat-color-on-secondary-container	رنگ متن و نمادها در برابر رنگ ظرف ثانویه. برای متن و آیکون دکمه استفاده می شود.
--gmp-mat-color-on-surface	رنگ برای متن و نمادها در برابر رنگ سطح. برای سرفصل ها و محتوای گفتگو استفاده می شود.
--gmp-mat-color-on-surface-variant	رنگ با تاکید کمتر برای متن و نمادها در برابر رنگ سطح. برای اطلاعات مکان استفاده می شود.
--gmp-mat-color-outline-decorative	رنگ طرح عناصر غیر تعاملی برای حاشیه کانتینر استفاده می شود.
--gmp-mat-color-positive	رنگ عناصر رابط کاربری با احساسات مثبت. برای برچسب "باز" ​​برای ساعات کاری یک مکان استفاده می شود.
--gmp-mat-color-primary	رنگ متن تعاملی و نمادها در برابر رنگ سطح. برای پیوندها، نشانگر بارگیری و نمادهای نمای کلی استفاده می شود.
--gmp-mat-color-secondary-container	رنگ پرکننده کمتر در برابر یک سطح. برای پس زمینه دکمه استفاده می شود.
--gmp-mat-color-surface	رنگ برای پس زمینه برای پس زمینه کانتینر و دیالوگ استفاده می شود.
--gmp-mat-font-body-small	برای اطلاعات مکان استفاده می شود.
--gmp-mat-font-family	خانواده فونت پایه برای تمام متن ها.
--gmp-mat-font-headline-medium	برای عناوین گفتگو استفاده می شود.
--gmp-mat-font-label-large	برای محتوای دکمه استفاده می شود.
--gmp-mat-font-title-medium	برای نام مکان استفاده می شود.
--gmp-mat-spacing-extra-small	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-large	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-medium	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-mat-spacing-small	برای فاصله گذاری درون عنصر مانند حاشیه و بالشتک دور متن استفاده می شود.
--gmp-star-rating-color	رنگ ستاره های پر شده در رتبه بندی ستاره.
--gmp-thumbnail-border-radius	شعاع حاشیه برای تصویر کوچک مکان.
background-color	رنگ پس‌زمینه عنصر را لغو می‌کند.
border	مرز عنصر را لغو می کند.
border-radius	شعاع مرزی عنصر را لغو می کند.
color-scheme	نشان می دهد که این عنصر در کدام طرح رنگی می تواند رندر شود. برای جزئیات بیشتر به مستندات color-scheme مراجعه کنید. پیش‌فرض‌های color-scheme: light dark .
font-size	مقیاس تمام متن و نمادهای موجود در عنصر. پیش‌فرض 16px است.

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رویدادها
gmp-error	function(event) استدلال ها: event : Event این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-load	function(event) استدلال ها: event : Event این رویداد زمانی فعال می شود که عنصر محتوای خود را بارگذاری و ارائه می کند. این رویداد حباب نمی کند.
gmp-select	function(event) استدلال ها: event : PlaceSelectEvent این رویداد زمانی فعال می شود که مکانی از لیست انتخاب شود. شامل یک شی Place حاوی شناسه، مکان و نمای مکان انتخاب شده است.

رابط PlaceSearchElementOptions

google.maps.places . PlaceSearchElementOptions رابط google.maps.places . PlaceSearchElementOptions

گزینه‌های PlaceSearchElement .

خواص
attributionPosition optional	نوع: PlaceSearchAttributionPosition optional PlaceSearchElement.attributionPosition ببینید.
orientation optional	نوع: PlaceSearchOrientation optional PlaceSearchElement.orientation را ببینید.
selectable optional	نوع: boolean optional PlaceSearchElement.selectable را ببینید
truncationPreferred optional	نوع: boolean optional PlaceSearchElement.truncationPreferred را ببینید.

ثابت های PlaceSearchAttributionPosition

google.maps.places . PlaceSearchAttributionPosition ثابت های google.maps.places . PlaceSearchAttributionPosition

موقعیت های انتساب برای PlaceSearchElement .

با فراخوانی const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

ثابت ها
BOTTOM	ذکر منبع در پایین PlaceSearchElement
TOP	Attribution در بالای PlaceSearchElement

ثابت های PlaceSearchOrientation

google.maps.places . PlaceSearchOrientation ثابت های google.maps.places . PlaceSearchOrientation

انواع جهت گیری برای PlaceSearchElement .

با فراخوانی const {PlaceSearchOrientation} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

ثابت ها
HORIZONTAL	جهت گیری افقی.
VERTICAL	جهت گیری عمودی

کلاس PlaceSelectEvent

google.maps.places . PlaceSelectEvent کلاس google.maps.places . PlaceSelectEvent

این رویداد زمانی فعال می‌شود که مکانی از فهرست مکان‌ها انتخاب شود. با event.place به انتخاب دسترسی پیدا کنید.

این کلاس Event را گسترش می دهد.

با فراخوانی const {PlaceSelectEvent} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

خواص
place	نوع: Place مکان انتخاب شده

کلاس PlaceNearbySearchRequestElement

google.maps.places . PlaceNearbySearchRequestElement کلاس google.maps.places . PlaceNearbySearchRequestElement

یک PlaceSearchElement برای بارگیری نتایج بر اساس درخواست جستجوی نزدیک پیکربندی می کند. ویژگی locationRestriction برای بارگیری عنصر جستجو مورد نیاز است. اگر locationRestriction تنظیم نشده باشد، سایر ویژگی های پیکربندی شده نادیده گرفته می شود. برای بارگیری نتایج، این عنصر را به عنوان فرزند PlaceSearchElement اضافه کنید. به عنوان مثال:

 <gmp-place-search>
   <gmp-place-nearby-search-request
     location-restriction="RADIUS@LAT,LNG"
   ></gmp-place-nearby-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search> 

عنصر سفارشی:
<gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..." excluded-types="excluded-type1 excluded-type2..." included-primary-types="included-primary-type1 included-primary-type2..." included-types="included-type1 included-type2..." location-restriction="radius@lat,lng" max-result-count="number" rank-preference="preference"></gmp-place-nearby-search-request>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceNearbySearchRequestElementOptions را پیاده سازی می کند.

با فراخوانی const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceNearbySearchRequestElement	PlaceNearbySearchRequestElement([options]) پارامترها: options : PlaceNearbySearchRequestElementOptions optional

خواص
excludedPrimaryTypes	نوع: Array <string> optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."></gmp-place-nearby-search-request>
excludedTypes	نوع: Array <string> optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request excluded-types="excluded-type1 excluded-type2..."></gmp-place-nearby-search-request>
includedPrimaryTypes	نوع: Array <string> optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request included-primary-types="included-primary-type1 included-primary-type2..."></gmp-place-nearby-search-request>
includedTypes	نوع: Array <string> optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request included-types="included-type1 included-type2..."></gmp-place-nearby-search-request>
locationRestriction	نوع: Circle | CircleLiteral optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request location-restriction="radius@lat,lng"></gmp-place-nearby-search-request>
maxResultCount	نوع: number optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request max-result-count="number"></gmp-place-nearby-search-request>
rankPreference	نوع: SearchNearbyRankPreference optional پیش فرض: null ویژگی HTML: <gmp-place-nearby-search-request rank-preference="preference"></gmp-place-nearby-search-request>

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceNearbySearchRequestElementOptions

google.maps.places . PlaceNearbySearchRequestElementOptions رابط google.maps.places . PlaceNearbySearchRequestElementOptions

گزینه‌های PlaceNearbySearchRequestElement .

خواص
excludedPrimaryTypes optional	نوع: Array <string> optional انواع مکان اصلی مستثنی شده است. برای جزئیات بیشتر به PlaceNearbySearchRequestElement.excludedPrimaryTypes و SearchNearbyRequest.excludedPrimaryTypes مراجعه کنید.
excludedTypes optional	نوع: Array <string> optional انواع مکان های مستثنی شده برای جزئیات بیشتر به PlaceNearbySearchRequestElement.excludedTypes و SearchNearbyRequest.excludedTypes مراجعه کنید.
includedPrimaryTypes optional	نوع: Array <string> optional شامل انواع مکان اصلی. برای جزئیات بیشتر به PlaceNearbySearchRequestElement.includedPrimaryTypes و SearchNearbyRequest.includedPrimaryTypes مراجعه کنید.
includedTypes optional	نوع: Array <string> optional شامل انواع مکان برای جزئیات بیشتر به PlaceNearbySearchRequestElement.includedTypes و SearchNearbyRequest.includedTypes مراجعه کنید.
locationRestriction optional	نوع: Circle | CircleLiteral optional منطقه ای برای جستجو برای جزئیات بیشتر به PlaceNearbySearchRequestElement.locationRestriction و SearchNearbyRequest.locationRestriction مراجعه کنید.
maxResultCount optional	نوع: number optional حداکثر تعداد نتایج برای بازگشت. برای جزئیات بیشتر به PlaceNearbySearchRequestElement.maxResultCount و SearchNearbyRequest.maxResultCount مراجعه کنید.
rankPreference optional	نوع: SearchNearbyRankPreference optional نتایج چگونه در پاسخ رتبه بندی خواهند شد. برای جزئیات بیشتر به PlaceNearbySearchRequestElement.rankPreference و SearchNearbyRankPreference مراجعه کنید.

کلاس PlaceTextSearchRequestElement

google.maps.places . PlaceTextSearchRequestElement کلاس google.maps.places . PlaceTextSearchRequestElement

یک PlaceSearchElement برای بارگیری نتایج بر اساس درخواست جستجوی متن پیکربندی می کند. ویژگی textQuery برای بارگیری عنصر جستجو مورد نیاز است. اگر textQuery تنظیم نشود، سایر خصوصیات پیکربندی شده نادیده گرفته می شود. برای بارگیری نتایج، این عنصر را به عنوان فرزند PlaceSearchElement اضافه کنید. به عنوان مثال:

 <gmp-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <gmp-place-content-config>
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </gmp-place-content-config>
 </gmp-place-search> 

عنصر سفارشی:
<gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..." ev-minimum-charging-rate-kw="rate" included-type="type" is-open-now="true" location-bias="lat,lng" location-restriction="swlat,swlng|nelat,nelng" max-result-count="number" min-rating="number" price-levels="price-level1 price-level2..." rank-preference="preference" text-query="string" use-strict-type-filtering></gmp-place-text-search-request>

این کلاس HTMLElement را گسترش می دهد.

این کلاس PlaceTextSearchRequestElementOptions پیاده سازی می کند.

با فراخوانی const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
PlaceTextSearchRequestElement	PlaceTextSearchRequestElement([options]) پارامترها: options : PlaceTextSearchRequestElementOptions optional

خواص
evConnectorTypes	نوع: Array < EVConnectorType > optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request ev-connector-types="ev-connector-type1 ev-connector-type2..."></gmp-place-text-search-request>
evMinimumChargingRateKw	نوع: number optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request ev-minimum-charging-rate-kw="rate"></gmp-place-text-search-request>
includedType	نوع: string optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request included-type="type"></gmp-place-text-search-request>
isOpenNow	نوع: boolean optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request is-open-now="true"></gmp-place-text-search-request>
locationBias	نوع: string| LatLngAltitude | LatLngBounds | Circle | LatLng | LatLngLiteral | LatLngAltitudeLiteral | LatLngBoundsLiteral | CircleLiteral optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request location-bias="lat,lng"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="lat,lng[,altitude]"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="swlat,swlng|nelat,nelng"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="radius@lat,lng"></gmp-place-text-search-request> <gmp-place-text-search-request location-bias="IP_BIAS"></gmp-place-text-search-request>
locationRestriction	نوع: LatLngBounds | LatLngBoundsLiteral optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request location-restriction="swlat,swlng|nelat,nelng"></gmp-place-text-search-request>
maxResultCount	نوع: number optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request max-result-count="number"></gmp-place-text-search-request>
minRating	نوع: number optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request min-rating="number"></gmp-place-text-search-request>
priceLevels	نوع: Array < PriceLevel > optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request price-levels="price-level1 price-level2..."></gmp-place-text-search-request>
rankPreference	نوع: SearchByTextRankPreference optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request rank-preference="preference"></gmp-place-text-search-request>
textQuery	نوع: string optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request text-query="string"></gmp-place-text-search-request>
useStrictTypeFiltering	نوع: boolean optional پیش فرض: null ویژگی HTML: <gmp-place-text-search-request use-strict-type-filtering></gmp-place-text-search-request>

روش ها
addEventListener	addEventListener(type, listener[, options]) پارامترها: type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است. listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند. مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
removeEventListener	removeEventListener(type, listener[, options]) پارامترها: type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند. listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد. options : boolean| EventListenerOptions optional گزینه ها را ببینید. مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceTextSearchRequestElementOptions

google.maps.places . PlaceTextSearchRequestElementOptions رابط google.maps.places . PlaceTextSearchRequestElementOptions

گزینه‌های PlaceTextSearchRequestElement .

خواص
evConnectorTypes optional	نوع: Array < EVConnectorType > optional فهرست انواع کانکتورهای EV ترجیحی. برای جزئیات بیشتر به SearchByTextRequest.evSearchOptions و PlaceTextSearchRequestElement.evConnectorTypes مراجعه کنید.
evMinimumChargingRateKw optional	نوع: number optional حداقل نرخ شارژ مورد نیاز بر حسب کیلووات. برای جزئیات بیشتر به SearchByTextRequest.evSearchOptions و PlaceTextSearchRequestElement.evMinimumChargingRateKw مراجعه کنید.
includedType optional	نوع: string optional نوع مکان درخواستی برای جزئیات بیشتر به SearchByTextRequest.includedType و PlaceTextSearchRequestElement.includedType مراجعه کنید.
isOpenNow optional	نوع: boolean optional برای محدود کردن جستجو به مکان‌هایی که در حال حاضر باز هستند استفاده می‌شود. برای جزئیات بیشتر به SearchByTextRequest.isOpenNow و PlaceTextSearchRequestElement.isOpenNow مراجعه کنید.
locationBias optional	نوع: string| LatLngAltitude | LatLngBounds | Circle | LatLng | LatLngLiteral | LatLngAltitudeLiteral | LatLngBoundsLiteral | CircleLiteral optional تعصب موقعیت مکانی برای جستجو برای جزئیات بیشتر SearchByTextRequest.locationBias و PlaceTextSearchRequestElement.locationBias را ببینید.
locationRestriction optional	نوع: LatLngBounds | LatLngBoundsLiteral optional محدودیت مکان برای جستجو برای جزئیات بیشتر SearchByTextRequest.locationRestriction و PlaceTextSearchRequestElement.locationRestriction را ببینید.
maxResultCount optional	نوع: number optional حداکثر تعداد نتایج برای بازگشت. برای جزئیات بیشتر SearchByTextRequest.maxResultCount و PlaceTextSearchRequestElement.maxResultCount را ببینید.
minRating optional	نوع: number optional نتایجی را فیلتر کنید که میانگین امتیاز آنها از این حد کمتر است. برای جزئیات بیشتر به SearchByTextRequest.minRating و PlaceTextSearchRequestElement.minRating مراجعه کنید.
priceLevels optional	نوع: Array < PriceLevel > optional برای محدود کردن جستجو به مکان‌هایی که به‌عنوان سطوح قیمت مشخص علامت‌گذاری شده‌اند استفاده می‌شود. برای جزئیات بیشتر به SearchByTextRequest.priceLevels و PlaceTextSearchRequestElement.priceLevels مراجعه کنید.
rankPreference optional	نوع: SearchByTextRankPreference optional نتایج چگونه در پاسخ رتبه بندی خواهند شد. برای جزئیات بیشتر به SearchByTextRequest.rankPreference و PlaceTextSearchRequestElement.rankPreference مراجعه کنید.
textQuery optional	نوع: string optional پرس و جو متن برای جستجوی متنی. برای اطلاعات بیشتر به SearchByTextRequest.textQuery و PlaceTextSearchRequestElement.textQuery مراجعه کنید.
useStrictTypeFiltering optional	نوع: boolean optional برای تنظیم فیلتر نوع سخت برای SearchByTextRequest.includedType استفاده می شود. برای اطلاعات بیشتر به SearchByTextRequest.useStrictTypeFiltering و PlaceTextSearchRequestElement.useStrictTypeFiltering مراجعه کنید.

کلاس ناقص

google.maps.places . Autocomplete کلاس google.maps.places . Autocomplete

مستهلک: از اول مارس 2025 ، Google.maps.places.AutoClote در دسترس مشتریان جدید نیست. لطفاً به جای آن از PlaceAutocompleteElement استفاده کنید. در این زمان ، Google.maps.Places.AutoClote برنامه ریزی نشده است که قطع شود ، اما PlaceAutocompleteElement از طریق Google.maps.places.AutoClette توصیه می شود. در حالی که Google.maps.places.AutoClote ادامه می یابد تا رفع اشکال برای هرگونه رگرسیون اصلی ، اشکالات موجود در Google.maps.places.AutoClote مورد توجه قرار نمی گیرد. حداقل 12 ماه قبل از قطع پشتیبانی اطلاع رسانی خواهد شد. لطفاً برای جزئیات بیشتر به https://developers.google.com/maps/legacy مراجعه کنید و https://developers.google.com/maps/documentation/javascript/places-migration-overview برای راهنمای مهاجرت.

ویجت که پیش بینی های مکان را بر اساس ورودی متن کاربر ارائه می دهد. آن را به یک عنصر ورودی text نوع متصل می کند و برای ورود متن در آن قسمت گوش می دهد. لیست پیش بینی ها به عنوان یک لیست کشویی ارائه شده و با وارد کردن متن به روز می شود.

این کلاس MVCObject را گسترش می دهد.

دسترسی با تماس با const {Autocomplete} = await google.maps.importLibrary("places") .
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
Autocomplete	Autocomplete(inputField[, opts]) پارامترها: inputField : HTMLInputElement قسمت <input> متن را که باید به Autocomplete وصل شود. opts : گزینه های AutocompleteOptions optional . نمونه جدیدی از Autocomplete را ایجاد می کند که با گزینه های داده شده به قسمت متن ورودی مشخص شده متصل می شود.

روش ها
getBounds	getBounds() پارامترها: ندارد مقدار بازگشت: LatLngBounds |undefined . مرزهایی را که پیش بینی ها مغرضانه هستند ، برمی گرداند.
getFields	getFields() پارامترها: ندارد مقدار بازگشت: Array <string>|undefined هنگامی که جزئیات با موفقیت بازیابی می شوند ، زمینه هایی را که برای مکان در پاسخ جزئیات قرار می گیرد ، باز می گرداند. برای لیستی از زمینه ها به PlaceResult مراجعه کنید.
getPlace	getPlace() پارامترها: ندارد مقدار بازگشت: PlaceResult مکان انتخاب شده توسط کاربر. در صورت بازیابی جزئیات ، جزئیات مکان انتخاب شده توسط کاربر را برمی گرداند. در غیر این صورت ، یک شیء مکان خرد را با ویژگی name تنظیم شده به مقدار فعلی قسمت ورودی تنظیم می کند.
setBounds	setBounds(bounds) پارامترها: bounds : LatLngBounds | LatLngBoundsLiteral optional محدوده های مغرضانه. ارزش بازگشتی: ندارد منطقه مورد نظر را برای بازگشت نتایج مکان تنظیم می کند. نتایج نسبت به این منطقه مغرضانه ، اما محدود به آن نیست.
setComponentRestrictions	setComponentRestrictions(restrictions) پارامترها: restrictions : ComponentRestrictions optional . ارزش بازگشتی: ندارد محدودیت های مؤلفه را تعیین می کند. محدودیت‌های مؤلفه برای محدود کردن پیش‌بینی‌ها فقط به آنهایی که در مؤلفه اصلی هستند استفاده می‌شوند. مثلا کشور.
setFields	setFields(fields) پارامترها: fields : Array <string> optional ارزش بازگشتی: ندارد هنگام بازیابی جزئیات ، زمینه هایی را که برای مکان در پاسخ به جزئیات درج شده است ، تنظیم می کند. برای لیستی از زمینه ها به PlaceResult مراجعه کنید.
setOptions	setOptions(options) پارامترها: options : AutocompleteOptions optional ارزش بازگشتی: ندارد
setTypes	setTypes(types) پارامترها: types : Array <string> optional انواع پیش بینی هایی که باید گنجانده شود. ارزش بازگشتی: ندارد انواع پیش بینی ها را بازگرداند. برای انواع پشتیبانی شده، به راهنمای برنامه نویس مراجعه کنید. اگر هیچ نوع مشخص نشده باشد، همه انواع برگردانده می شوند.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll

رویدادها
place_changed	function() استدلال ها: هیچ این رویداد هنگامی اخراج می شود که یک PlaceResult برای مکانی که کاربر انتخاب کرده است در دسترس قرار گیرد. اگر کاربر نام مکانی را که توسط کنترل پیشنهاد نشده است وارد کند و کلید Enter را فشار دهد ، یا اگر یک درخواست جزئیات در مکان انجام نشود ، PlaceResult حاوی ورودی کاربر در ویژگی name است و هیچ ویژگی دیگری تعریف نشده است.

رابط خودکار

google.maps.places . AutocompleteOptions رابط google.maps.places . AutocompleteOptions

گزینه هایی که می توان روی یک شیء Autocomplete تنظیم کرد.

خواص
bounds optional	نوع: LatLngBounds | LatLngBoundsLiteral optional منطقه ای که در آن می توانید مکان ها را جستجو کنید.
componentRestrictions optional	نوع: ComponentRestrictions optional محدودیت های مولفه محدودیت‌های مؤلفه برای محدود کردن پیش‌بینی‌ها فقط به آنهایی که در مؤلفه اصلی هستند استفاده می‌شوند. مثلا کشور.
fields optional	نوع: Array <string> optional زمینه هایی که باید برای مکان در پاسخ به جزئیات در هنگام بازیابی جزئیات درج شود ، که برای آن صورتحساب می شود . اگر ['ALL'] منتقل شود ، تمام زمینه های موجود بازگردانده و صورتحساب می شوند (این برای استقرار تولید توصیه نمی شود). برای لیستی از زمینه ها به PlaceResult مراجعه کنید. زمینه های تو در تو را می توان با مسیرهای نقطه (به عنوان مثال "geometry.location" ) مشخص کرد. پیش فرض ['ALL'] است.
placeIdOnly optional	مستهلک: placeIdOnly از 15 ژانویه 2019 مستهلک می شود و در 15 ژانویه 2020 خاموش خواهد شد. از AutocompleteOptions.fields استفاده کنید: در عوض: fields: ['place_id', 'name', 'types'] . نوع: boolean optional آیا فقط می توان شناسه های مکان را بازیابی کرد. Placeresult که در صورت اخراج رویداد place_changed در دسترس است ، فقط دارای قسمت های place_id ، انواع و نام ، با مکان_id ، انواع و توضیحات توسط سرویس خودکار است. به طور پیش فرض غیرفعال است.
strictBounds optional	نوع: boolean optional یک مقدار بولی ، نشان می دهد که ویجت اتوماتیک فقط باید مکانهایی را که در محدوده ویجت خودکار در زمان ارسال پرس و جو قرار دارند ، برگرداند. تنظیم سختگیرانه به false (که پیش فرض است) باعث می شود که نتایج به سمت مکانهای موجود در محدوده ، اما محدود به آن نباشد.
types optional	نوع: Array <string> optional انواع پیش بینی هایی که باید برگردانده شوند. برای انواع پشتیبانی شده، به راهنمای برنامه نویس مراجعه کنید. اگر هیچ نوع مشخص نشده باشد، همه انواع برگردانده می شوند.

کلاس SearchBox

google.maps.places . SearchBox کلاس google.maps.places . SearchBox

کاهش یافته: از اول مارس 2025 ، Google.maps.places.Searchbox در دسترس مشتریان جدید نیست. در این زمان ، Google.maps.Places.Searchbox قرار نیست قطع شود و همچنان به رفع اشکال برای هرگونه رگرسیون بزرگ ادامه خواهد داد. حداقل 12 ماه قبل از قطع پشتیبانی اطلاع رسانی خواهد شد. لطفاً برای جزئیات بیشتر به https://developers.google.com/maps/legacy مراجعه کنید.

ویجت که پیش بینی های پرس و جو را بر اساس ورودی متن کاربر ارائه می دهد. آن را به یک عنصر ورودی text نوع متصل می کند و برای ورود متن در آن قسمت گوش می دهد. لیست پیش بینی ها به عنوان یک لیست کشویی ارائه شده و با وارد کردن متن به روز می شود.

این کلاس MVCObject را گسترش می دهد.

دسترسی با تماس با const {SearchBox} = await google.maps.importLibrary("places") .
کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
SearchBox	SearchBox(inputField[, opts]) پارامترها: inputField : HTMLInputElement opts : SearchBoxOptions optional نمونه جدیدی از SearchBox ایجاد می کند که با گزینه های داده شده به قسمت متن ورودی مشخص شده متصل می شود.

روش ها
getBounds	getBounds() پارامترها: ندارد مقدار بازگشت: LatLngBounds |undefined مرزهایی را که پیش بینی های پرس و جو به آنها تعصب دارند ، برمی گرداند.
getPlaces	getPlaces() پارامترها: ندارد مقدار بازگشت: Array < PlaceResult >|undefined پرس و جو انتخاب شده توسط کاربر را برای استفاده از رویداد places_changed انتخاب می کند.
setBounds	setBounds(bounds) پارامترها: bounds : LatLngBounds | LatLngBoundsLiteral optional ارزش بازگشتی: ندارد منطقه را برای استفاده برای پیش بینی های پرس و جو مغرضانه تنظیم می کند. نتایج فقط نسبت به این منطقه مغرضانه خواهد بود و کاملاً محدود به آن نمی شود.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll

رویدادها
places_changed	function() استدلال ها: هیچ این رویداد هنگامی که کاربر یک پرس و جو را انتخاب می کند ، اخراج می شود ، برای به دست آوردن مکان های جدید باید از getPlaces استفاده شود.

رابط SearchboxOptions

google.maps.places . SearchBoxOptions رابط google.maps.places . SearchBoxOptions

گزینه هایی که می توان در یک شیء SearchBox تنظیم کرد.

خواص
bounds optional	نوع: LatLngBounds | LatLngBoundsLiteral optional منطقه ای که پیش بینی های پرس و جو را به سمت آن تعصب می کند. پیش بینی ها نسبت به نمایش داده شدگان ، اما محدود به این محدودیت ها نیستند.