Places Widgets

PlaceAutocompleteElement class

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

‫PlaceAutocompleteElement یک زیرکلاس HTMLElement است که مؤلفه واسط کاربر را برای Places Autocomplete API ارائه می‌دهد.

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

اولین تماس با 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)
پارامترها: 
includedPrimaryTypes
نوع:  Array<string> optional
نوع مکان اصلی گنجانده‌شده (برای مثال، «رستوران» یا «پمپ بنزین»).

«مکان» فقط درصورتی برگردانده می‌شود که نوع اصلی آن در این فهرست گنجانده شده باشد. حداکثر ۵ مقدار را می‌توان مشخص کرد. اگر هیچ نوعی مشخص نشده باشد، همه انواع «مکان» برگردانده می‌شود.
مشخصه HTML:
  • <gmp-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-place-autocomplete>
includedRegionCodes
نوع:  Array<string> optional
فقط نتایج را در مناطق مشخص‌شده، که حداکثر با ۱۵ کد منطقه دوحرفی 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 مراجعه کنید. از همان رفتار مشخصه نام برای ورودی‌ها پیروی می‌کند. توجه داشته باشید که این نامی است که هنگام ارسال فرم استفاده خواهد شد. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form مراجعه کنید.
مشخصه HTML:
  • <gmp-place-autocomplete name="string"></gmp-place-autocomplete>
origin
مبدأی که فاصله از آن محاسبه می‌شود. اگر مشخص نشده باشد، فاصله محاسبه نمی‌شود. ارتفاع، درصورت ارائه، در محاسبه استفاده نمی‌شود.
مشخصه HTML:
  • <gmp-place-autocomplete origin="lat,lng"></gmp-place-autocomplete>
  • <gmp-place-autocomplete origin="lat,lng,altitude"></gmp-place-autocomplete>
placeholder
نوع:  string
نوشتار جای‌بان برای نمایش در عنصر ورودی.
requestedLanguage
نوع:  string optional
شناسه زبان برای زبانی که نتایج باید به آن زبان برگردانده شود (درصورت امکان). نتایج به زبان انتخابی ممکن است رتبه بالاتری داشته باشند، اما پیشنهادها به این زبان محدود نمی‌شوند. فهرست زبان‌های پشتیبانی‌شده را ببینید.
مشخصه HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
نوع:  string optional
کد منطقه‌ای که برای قالب‌بندی نتیجه و فیلتر کردن نتیجه استفاده می‌شود. این گزینه پیشنهادها را به این کشور محدود نمی‌کند. کد منطقه مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») را می‌پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، دامنه سطح بالای کد کشوری پادشاهی متحد «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>
value
نوع:  string
مقدار عنصر ورودی.
prediction-item-icon
این جایگاه دقیقاً یک عنصر <template> را می‌پذیرد تا به‌عنوان نماد نشان‌داده‌شده در کنار مورد پیش‌بینی ارائه شود.
input
عنصر ورودی برای عنصر تکمیل خودکار.
prediction-item
موردی در منو کرکره‌ای پیش‌بینی‌ها که نشان‌دهنده یک پیش‌بینی است.
prediction-item-icon
نمادی که در سمت راست هر مورد در فهرست پیش‌بینی‌ها نمایش داده می‌شود.
prediction-item-main-text
بخشی از prediction-item که نوشتار اصلی پیش‌بینی است. برای مکان‌های جغرافیایی، این شامل نام مکان، مانند «سیدنی»، یا نام و شماره خیابان، مانند «خیابان کینگ ۱۰» است. به‌طور پیش‌فرض، prediction-item-main-text به رنگ سیاه است. اگر نوشتار دیگری در prediction-item وجود داشته باشد، خارج از prediction-item-main-text است و سبک خود را از prediction-item به‌ارث می‌برد. به‌طور پیش‌فرض خاکستری است. نوشتار اضافی معمولاً نشانی است.
prediction-item-match
بخشی از پیش‌بینی برگردانده‌شده که با ورودی کاربر مطابقت دارد. به‌طور پیش‌فرض، این نوشتار منطبق با نوشتار پررنگ برجسته می‌شود. توجه داشته باشید که نوشتار مطابقت‌داده‌شده ممکن است در هر جایی از prediction-item باشد. این مورد لزوماً بخشی از prediction-item-main-text نیست.
prediction-item-selected
موردی که کاربر ازطریق صفحه‌کلید به آن پیمایش می‌کند. توجه: موارد انتخاب‌شده هم تحت‌تأثیر سبک‌های این بخش و هم سبک‌های بخش مورد پیش‌بینی قرار می‌گیرند.
prediction-list
عنصر دیداری حاوی فهرست پیش‌بینی‌های برگردانده‌شده توسط سرویس «تکمیل خودکار جا». این فهرست به‌صورت فهرست کرکره‌ای در زیر PlaceAutocompleteElement نشان داده می‌شود.
background-color
رنگ پس‌زمینه عنصر را لغو می‌کند.
border
حاشیه عنصر را لغو می‌کند.
border-radius
شعاع حاشیه عنصر را لغو می‌کند.
color
قلم عنصر را لغو می‌کند.
color-scheme
نشان می‌دهد که این عنصر در کدام آرایش رنگ‌ها می‌تواند پرداز شود. برای جزئیات بیشتر، اسناد color-scheme را ببینید. پیش‌فرض‌ها به color-scheme: light dark.
font
قلم عنصر را لغو می‌کند.
font-family
قلم عنصر را لغو می‌کند.
font-size
قلم عنصر را لغو می‌کند.
font-style
قلم عنصر را لغو می‌کند.
font-weight
قلم عنصر را لغو می‌کند.
line-height
قلم عنصر را لغو می‌کند.
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)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
gmp-select
function(placePredictionSelectEvent)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که کاربر پیش‌بینی مکانی را انتخاب کند. حاوی شیء PlacePrediction است که می‌تواند به شیء Place تبدیل شود.

میانای 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
requestedLanguage optional
نوع:  string optional
requestedRegion optional
نوع:  string optional
unitSystem optional
نوع:  UnitSystem optional
value optional
نوع:  string optional
مقدار عنصر ورودی.

کلاس 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 تبدیل کنید.

کلاس BasicPlaceAutocompleteElement

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

BasicPlaceAutocompleteElement یک زیرکلاس HTMLElement است که مؤلفه واسط کاربر برای 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)
پارامترها: 
includedPrimaryTypes
نوع:  Array<string> optional
نوع مکان اصلی گنجانده‌شده (برای مثال، «رستوران» یا «پمپ بنزین»).

«مکان» فقط درصورتی برگردانده می‌شود که نوع اصلی آن در این فهرست گنجانده شده باشد. حداکثر ۵ مقدار را می‌توان مشخص کرد. اگر هیچ نوعی مشخص نشده باشد، همه انواع «مکان» برگردانده می‌شود.
مشخصه HTML:
  • <gmp-basic-place-autocomplete included-primary-types="type1 type2 type3..."></gmp-basic-place-autocomplete>
includedRegionCodes
نوع:  Array<string> optional
فقط نتایج را در مناطق مشخص‌شده، که حداکثر با ۱۵ کد منطقه دوحرفی 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 مراجعه کنید. از همان رفتار مشخصه نام برای ورودی‌ها پیروی می‌کند. توجه داشته باشید که این نامی است که هنگام ارسال فرم استفاده خواهد شد. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form مراجعه کنید.
مشخصه HTML:
  • <gmp-basic-place-autocomplete name="string"></gmp-basic-place-autocomplete>
origin
مبدأی که فاصله از آن محاسبه می‌شود. اگر مشخص نشده باشد، فاصله محاسبه نمی‌شود. ارتفاع، درصورت ارائه، در محاسبه استفاده نمی‌شود.
مشخصه 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 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، دامنه سطح بالای کد کشوری پادشاهی متحد «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> را می‌پذیرد تا به‌عنوان نماد نشان‌داده‌شده در کنار مورد پیش‌بینی ارائه شود.
input
عنصر ورودی برای عنصر تکمیل خودکار.
prediction-item
موردی در منو کرکره‌ای پیش‌بینی‌ها که نشان‌دهنده یک پیش‌بینی است.
prediction-item-icon
نمادی که در سمت راست هر مورد در فهرست پیش‌بینی‌ها نمایش داده می‌شود.
prediction-item-main-text
بخشی از prediction-item که نوشتار اصلی پیش‌بینی است. برای مکان‌های جغرافیایی، این شامل نام مکان، مانند «سیدنی»، یا نام و شماره خیابان، مانند «خیابان کینگ ۱۰» است. به‌طور پیش‌فرض، prediction-item-main-text به رنگ سیاه است. اگر نوشتار دیگری در prediction-item وجود داشته باشد، خارج از prediction-item-main-text است و سبک خود را از prediction-item به‌ارث می‌برد. به‌طور پیش‌فرض خاکستری است. نوشتار اضافی معمولاً نشانی است.
prediction-item-match
بخشی از پیش‌بینی برگردانده‌شده که با ورودی کاربر مطابقت دارد. به‌طور پیش‌فرض، این نوشتار منطبق با نوشتار پررنگ برجسته می‌شود. توجه داشته باشید که نوشتار مطابقت‌داده‌شده ممکن است در هر جایی از prediction-item باشد. این مورد لزوماً بخشی از prediction-item-main-text نیست.
prediction-item-selected
موردی که کاربر ازطریق صفحه‌کلید به آن پیمایش می‌کند. توجه: موارد انتخاب‌شده هم تحت‌تأثیر سبک‌های این بخش و هم سبک‌های بخش مورد پیش‌بینی قرار می‌گیرند.
prediction-list
عنصر دیداری حاوی فهرست پیش‌بینی‌های برگردانده‌شده توسط سرویس «تکمیل خودکار جا». این فهرست به‌صورت فهرست کرکره‌ای در زیر PlaceAutocompleteElement نشان داده می‌شود.
background-color
رنگ پس‌زمینه عنصر را لغو می‌کند.
border
حاشیه عنصر را لغو می‌کند.
border-radius
شعاع حاشیه عنصر را لغو می‌کند.
color
قلم عنصر را لغو می‌کند.
color-scheme
نشان می‌دهد که این عنصر در کدام آرایش رنگ‌ها می‌تواند پرداز شود. برای جزئیات بیشتر، اسناد color-scheme را ببینید. پیش‌فرض‌ها به color-scheme: light dark.
font
قلم عنصر را لغو می‌کند.
font-family
قلم عنصر را لغو می‌کند.
font-size
قلم عنصر را لغو می‌کند.
font-style
قلم عنصر را لغو می‌کند.
font-weight
قلم عنصر را لغو می‌کند.
line-height
قلم عنصر را لغو می‌کند.
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)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
gmp-select
function(placeSelectEvent)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که کاربر پیش‌بینی مکانی را انتخاب کند. حاوی شیء Place است.

میانای 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
requestedLanguage optional
نوع:  string optional
requestedRegion optional
نوع:  string optional
unitSystem optional
نوع:  UnitSystem optional

کلاس 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])
پارامترها: 
place
نوع:  Place optional
فقط خواندنی. شیء مکان حاوی شناسه، مکان، و نمای هدف مکان ارائه‌شده فعلی.
--gmp-button-border-color
رنگ حاشیه دکمه «باز کردن در Maps».
--gmp-button-border-radius
شعاع حاشیه دکمه «باز کردن در Maps».
--gmp-button-border-width
عرض حاشیه دکمه «باز کردن در Maps».
--gmp-collage-border-radius-outer
شعاع حاشیه گوشه‌های بیرونی کلاژ رسانه.
--gmp-dialog-border-radius
شعاع حاشیه کادر گفتگوی شفاف‌سازی Google Maps.
--gmp-mat-color-disabled-surface
رنگ سطح برای نشان دادن وضعیت‌های غیرفعال یا عدم حضور. برای ستاره‌های مرور خالی استفاده می‌شود.
--gmp-mat-color-info
رنگ عناصر میانای کاربر با حس اطلاعاتی. برای نماد صندلی چرخ‌دار استفاده می‌شود.
--gmp-mat-color-negative
رنگ عناصر میانای کاربر با حس منفی. برای نوشتار «بسته» در وضعیت «درحال‌حاضر باز» استفاده می‌شود.
--gmp-mat-color-neutral-container
رنگ ظرف برای عناصر میانای کاربر پرشده خنثی. برای جای‌بان‌های تصویر و نشان تاریخ انتشار مرور استفاده می‌شود.
--gmp-mat-color-on-neutral-container
رنگ نوشتار و نمادها درمقابل رنگ خنثی محفظه. برای نشان تاریخ انتشار مرور و نشان دردسترس بودن شارژر خودرو برقی درصورت دردسترس نبودن استفاده می‌شود.
--gmp-mat-color-on-positive-container
رنگ نوشتارها و نمادها درمقابل رنگ محفظه مثبت. درصورت دردسترس بودن، برای نشان دردسترس بودن شارژر خودرو برقی استفاده می‌شود.
--gmp-mat-color-on-secondary-container
رنگ نوشتار و نمادها درمقابل رنگ محفظه ثانویه. برای نوشتار و نمادهای روی دکمه «باز کردن در Maps» استفاده می‌شود.
--gmp-mat-color-on-surface
رنگ نوشتار و نمادها درمقابل هر رنگ سطحی. برای نوشتار معمولی استفاده می‌شود.
--gmp-mat-color-on-surface-variant
رنگ با تأکید کمتر برای نوشتار و نمادها درمقابل هر رنگ سطحی. برای نوشتار با تأکید کمتر استفاده می‌شود.
--gmp-mat-color-outline-decorative
رنگ طرح کلی عناصر غیرتعاملی. برای حاشیه عنصر استفاده می‌شود.
--gmp-mat-color-positive
رنگ عناصر میانای کاربر با حس مثبت. Used for "Open" text in open now status.
--gmp-mat-color-positive-container
رنگ محفظه برای عناصر میانای کاربر که احساسات مثبت را منتقل می‌کنند. درصورت دردسترس بودن، برای نشان دردسترس بودن شارژر خودرو برقی استفاده می‌شود.
--gmp-mat-color-primary
رنگ نوشتار و نمادهای تعاملی درمقابل رنگ سطح. برای تعداد مرور، پیوندها در کادر گفتگوی شفاف‌سازی‌های Google Maps، پیوند وب‌سایت، نمادها در برگه نمای کلی، و (رنگ نوشتار / تمرکز / نگه داشتن نشانگر) در عنوان‌های نوار برگه استفاده می‌شود.
--gmp-mat-color-secondary-container
رنگ پرکننده کمتر برجسته درمقابل سطح، برای مؤلفه‌های مغلوب مانند دکمه‌های تونال. برای پس‌زمینه دکمه «باز کردن در Maps» استفاده می‌شود.
--gmp-mat-color-surface
رنگ برای پس‌زمینه‌ها. برای پس‌زمینه‌های عنصر و کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-font-body-medium
برای نشانی، رده‌بندی، نوع، قیمت، وضعیت باز بودن، ساعات کاری، مرور، شماره تلفن، وب‌سایت، Plus Code، ویژگی‌های برتر، و نوشتار اصلی در کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-font-body-small
برای نوشتار اصلی در فهرست ویژگی‌ها در برگه «درباره» استفاده می‌شود.
--gmp-mat-font-display-small
برای نام مکان و نوشتار هر عنوان ویژگی در برگه «درباره» استفاده می‌شود.
--gmp-mat-font-family
خانواده قلم پایه مورداستفاده برای همه نوشتارها.
--gmp-mat-font-headline-medium
برای نوشتار عنوان در کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-font-label-large
برای عنوان‌های برگه، دکمه «باز کردن در Maps»، نوشتار ارجاع به مرورکننده در گالری عکس، نوشتار ارجاع به مرورکننده در بخش مرورها، و پیوندها در کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-font-label-medium
برای نشان تعداد عکس‌ها و نشان تاریخ انتشار مرور استفاده می‌شود.
--gmp-mat-font-title-small
Used for the title of each section in the 'About' tab.
--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)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
gmp-load
function(event)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.

میانای PlaceDetailsElementOptions

میانا google.maps.places.PlaceDetailsElementOptions

گزینه‌های PlaceDetailsElement.

کلاس 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])
پارامترها: 
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>
--gmp-button-border-color
رنگ حاشیه دکمه «باز کردن در Maps».
--gmp-button-border-radius
شعاع حاشیه دکمه «باز کردن در Maps».
--gmp-button-border-width
عرض حاشیه دکمه «باز کردن در Maps».
--gmp-dialog-border-radius
شعاع حاشیه کادر گفتگوی شفاف‌سازی Google Maps.
--gmp-mat-color-info
رنگ عناصر میانای کاربر با حس اطلاعاتی. برای نماد صندلی چرخ‌دار استفاده می‌شود.
--gmp-mat-color-negative
رنگ عناصر میانای کاربر با حس منفی. برای نوشتار «بسته» در وضعیت «درحال‌حاضر باز» استفاده می‌شود.
--gmp-mat-color-neutral-container
رنگ ظرف برای عناصر میانای کاربر پرشده خنثی. برای جای‌بان‌های تصویر استفاده می‌شود.
--gmp-mat-color-on-secondary-container
رنگ نوشتار و نمادها درمقابل رنگ محفظه ثانویه. برای نوشتار و نمادهای روی دکمه «باز کردن در Maps» استفاده می‌شود.
--gmp-mat-color-on-surface
رنگ نوشتار و نمادها درمقابل هر رنگ سطحی. برای نوشتار معمولی استفاده می‌شود.
--gmp-mat-color-on-surface-variant
رنگ با تأکید کمتر برای نوشتار و نمادها درمقابل هر رنگ سطحی. برای نوشتار با تأکید کمتر استفاده می‌شود.
--gmp-mat-color-outline-decorative
رنگ طرح کلی عناصر غیرتعاملی. برای حاشیه عنصر استفاده می‌شود.
--gmp-mat-color-positive
رنگ عناصر میانای کاربر با حس مثبت. Used for "Open" text in open now status.
--gmp-mat-color-primary
رنگ نوشتار و نمادهای تعاملی درمقابل رنگ سطح. برای تعداد مرورها و همچنین پیوندها در کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-color-secondary-container
رنگ پرکننده کمتر برجسته درمقابل سطح، برای مؤلفه‌های مغلوب مانند دکمه‌های تونال. برای پس‌زمینه دکمه «باز کردن در Maps» استفاده می‌شود.
--gmp-mat-color-surface
رنگ برای پس‌زمینه‌ها. برای پس‌زمینه‌های عنصر و کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-font-body-medium
Used for body text in the Google Maps disclosures dialog.
--gmp-mat-font-body-small
برای نشانی، رده‌بندی، نوع، قیمت، و وضعیت باز بودن مکان استفاده می‌شود.
--gmp-mat-font-family
خانواده قلم پایه مورداستفاده برای همه نوشتارها.
--gmp-mat-font-headline-medium
برای نوشتار عنوان در کادر گفتگوی شفاف‌سازی‌های Google Maps استفاده می‌شود.
--gmp-mat-font-label-large
برای دکمه «باز کردن در Maps» و همچنین پیوندها در کادر گفتگوی شفاف‌سازی‌های 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)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
gmp-load
function(event)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.

میانای PlaceDetailsCompactElementOptions

میانا google.maps.places.PlaceDetailsCompactElementOptions

گزینه‌های PlaceDetailsCompactElement.
orientation optional
نوع:  PlaceDetailsOrientation optional
PlaceDetailsCompactElement.orientation را ببینید.
truncationPreferred optional
نوع:  boolean optional
PlaceDetailsCompactElement.truncationPreferred را ببینید.

ثابت‌های PlaceDetailsOrientation

google.maps.places.PlaceDetailsOrientation یادآور همیشگی

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

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

کلاس 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])
پارامترها: 
place
نوع:  Place optional
پیش‌فرض: null
شیء، شناسه، یا نام منبع جا برای ارائه جزئیات در عنصر «جزئیات جا» فشرده. این ویژگی به مشخصه به‌عنوان نام منبع اشاره می‌کند.
مشخصه 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

گزینه‌های PlaceDetailsPlaceRequestElement.
place optional
نوع:  Place|string optional
مشاهده PlaceDetailsPlaceRequestElement.place

کلاس 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])
پارامترها: 
location
پیش‌فرض: null
مکانی که جزئیات آن در عنصر «جزئیات جا» پرداز می‌شود. به 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

گزینه‌های PlaceDetailsLocationRequestElement.
location optional
مکان برای ارائه مکان.

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>

برای استفاده از «عنصر جستجوی جاها»، Places UI Kit API را برای پروژه‌تان در کنسول 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])
پارامترها: 
attributionPosition
پیش‌فرض: 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>
--gmp-button-border-color
رنگ حاشیه دکمه «باز کردن در Maps».
--gmp-button-border-radius
شعاع حاشیه برای دکمه «باز کردن در Maps».
--gmp-button-border-width
عرض حاشیه برای دکمه «باز کردن در Maps».
--gmp-card-border-radius
شعاع حاشیه برای کارت‌های مکان.
--gmp-dialog-border-radius
شعاع حاشیه برای کادر گفتگوی شفاف‌سازی Google Maps.
--gmp-mat-color-info
رنگ عناصر میانای کاربر با حس اطلاعاتی. برای نماد ورودی مناسب برای صندلی چرخ‌دار استفاده می‌شود.
--gmp-mat-color-negative
رنگ عناصر میانای کاربر با حس منفی. Used for the "Closed" label for a place's opening hours.
--gmp-mat-color-neutral-container
رنگ ظرف برای عناصر میانای کاربر پرشده خنثی. برای نشان‌های تاریخ مرور و بار کردن شکل‌های جای‌بان استفاده می‌شود.
--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
رنگ عناصر میانای کاربر با حس مثبت. Used for the "Open" label for a place's opening hours.
--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)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
gmp-load
function(event)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.
gmp-select
function(event)
متغیرهای مستقل: 
این رویداد زمانی فعال می‌شود که مکانی از فهرست انتخاب شود. حاوی شیء Place است که شامل شناسه، مکان، و نمای دید مکان انتخاب‌شده است.

میانای PlaceSearchElementOptions

میانا google.maps.places.PlaceSearchElementOptions

گزینه‌های PlaceSearchElement.
attributionPosition 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 یادآور همیشگی

جایگاه‌های اِسناد برای PlaceSearchElement.

با تماس با const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
BOTTOM ارجاع در پایین PlaceSearchElement
TOP اسناددهی در بالای PlaceSearchElement

ثابت‌های PlaceSearchOrientation

google.maps.places.PlaceSearchOrientation یادآور همیشگی

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

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

کلاس PlaceSelectEvent

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

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

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

با تماس با const {PlaceSelectEvent} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
place
نوع:  Place
مکان انتخاب‌شده.

PlaceNearbySearchRequestElement class

‫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])
پارامترها: 
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
منطقه موردنظر برای جستجو. به Circle نرمال‌سازی می‌شود.
مشخصه 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

گزینه‌های 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 کلاس

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])
پارامترها: 
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
نوع:  LocationBias optional
پیش‌فرض: null
سوگیری مکان برای جستجو. به LatLngAltitude | LatLngBounds | Circle | string نرمال‌سازی می‌شود.
مشخصه 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
پیش‌فرض: null
محدودیت مکان برای جستجو. به LatLngBounds نرمال‌سازی می‌شود.
مشخصه 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
برای تنظیم فیلتر نوع دقیق برای «includedType» استفاده می‌شود.
مشخصه 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

گزینه‌های PlaceTextSearchRequestElement.
evConnectorTypes optional
نوع:  Array<EVConnectorType> optional
فهرست انواع رابط‌های خودرو برقی ترجیحی. برای جزئیات بیشتر، به 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
نوع:  LocationBias optional
سوگیری مکان برای جستجو. برای جزئیات بیشتر، به SearchByTextRequest.locationBias و PlaceTextSearchRequestElement.locationBias مراجعه کنید.
locationRestriction 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 کلاس

ابزارکی که پیش‌بینی‌های «مکان» را براساس ورودی نوشتاری کاربر ارائه می‌دهد. این ویژگی به عنصر ورودی از نوع text متصل می‌شود و به ورودی نوشتاری در آن فیلد گوش می‌دهد. فهرست پیش‌بینی‌ها به‌صورت فهرست کرکره‌ای ارائه می‌شود و با وارد کردن نوشتار به‌روز می‌شود.

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

با تماس با const {Autocomplete} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
Autocomplete
Autocomplete(inputField[, opts])
پارامترها: 
نمونه جدیدی از Autocomplete ایجاد می‌کند که با گزینه‌های ارائه‌شده به فیلد نوشتار ورودی مشخص‌شده پیوست می‌شود.
getBounds
getBounds()
پارامترها:  هیچ
مقدار برگشتی:  LatLngBounds|undefined مرزهای سوگیری.
محدوده‌هایی را که پیش‌بینی‌ها به آن‌ها سوگیری دارند برمی‌گرداند.
getFields
getFields()
پارامترها:  هیچ
مقدار برگشتی:  Array<string>|undefined
فیلدهایی را که باید برای «مکان» در پاسخ جزئیات گنجانده شوند، درصورت بازیابی موفقیت‌آمیز جزئیات، برمی‌گرداند. برای مشاهده فهرست فیلدها، PlaceResult را ببینید.
getPlace
getPlace()
پارامترها:  هیچ
مقدار بازگشتی:  PlaceResult «مکان» انتخاب‌شده توسط کاربر.
اگر جزئیات باموفقیت بازیابی شده باشد، جزئیات «مکان» انتخاب‌شده توسط کاربر را برمی‌گرداند. درغیراین‌صورت، یک شیء «مکان» ناقص برمی‌گرداند که ویژگی name آن روی مقدار فعلی فیلد ورودی تنظیم شده است.
setBounds
setBounds(bounds)
پارامترها: 
مقدار برگشتی:  هیچ
منطقه ترجیحی را که نتایج «مکان» در آن برگردانده می‌شود تنظیم می‌کند. نتایج به این منطقه متمایل است، اما به آن محدود نمی‌شود.
setComponentRestrictions
setComponentRestrictions(restrictions)
پارامترها: 
مقدار برگشتی:  هیچ
محدودیت‌های مؤلفه را تنظیم می‌کند. از محدودیت‌های مؤلفه برای محدود کردن پیش‌بینی‌ها به موارد موجود در مؤلفه اصلی استفاده می‌شود. برای مثال، کشور.
setFields
setFields(fields)
پارامترها: 
  • ‫fields:  Array<string> optional
مقدار برگشتی:  هیچ
فیلدهایی را که باید برای «مکان» در پاسخ جزئیات گنجانده شوند، درصورت بازیابی موفقیت‌آمیز جزئیات، تنظیم می‌کند. برای مشاهده فهرست فیلدها، PlaceResult را ببینید.
setOptions
setOptions(options)
پارامترها: 
مقدار برگشتی:  هیچ
setTypes
setTypes(types)
پارامترها: 
  • ‫types:  Array<string> optional انواع پیش‌بینی‌هایی که باید گنجانده شود.
مقدار برگشتی:  هیچ
انواع پیش‌بینی‌هایی را که باید برگردانده شوند تنظیم می‌کند. برای انواع پشتیبانی‌شده، راهنمای توسعه‌دهنده را ببینید. اگر نوعی مشخص نشده باشد، همه انواع برگردانده خواهد شد.
به‌ارث‌رسیده: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
place_changed
function()
متغیرهای مستقل:  هیچ
این رویداد زمانی فعال می‌شود که PlaceResult برای «مکانی» که کاربر انتخاب کرده است دردسترس قرار گیرد.
اگر کاربر نام مکانی را وارد کند که توسط کنترل پیشنهاد نشده است و کلید Enter را فشار دهد، یا اگر درخواست «جزئیات مکان» ناموفق باشد، PlaceResult حاوی ورودی کاربر در ویژگی name خواهد بود و هیچ ویژگی دیگری تعریف نمی‌شود.

میانای AutocompleteOptions

میانا google.maps.places.AutocompleteOptions

گزینه‌هایی که می‌توانند روی شیء Autocomplete تنظیم شوند.
bounds optional
منطقه‌ای که مکان‌ها در آن جستجو می‌شود.
componentRestrictions optional
نوع:  ComponentRestrictions optional
محدودیت‌های مؤلفه. از محدودیت‌های مؤلفه برای محدود کردن پیش‌بینی‌ها به موارد موجود در مؤلفه اصلی استفاده می‌شود. برای مثال، کشور.
fields optional
نوع:  Array<string> optional
فیلدهایی که باید برای «مکان» در پاسخ جزئیات گنجانده شود، وقتی جزئیات با موفقیت بازیابی می‌شود، که برای آن صورت‌حساب صادر خواهد شد. اگر ['ALL'] وارد شود، همه فیلدهای دردسترس برگردانده می‌شوند و صورت‌حساب برای آن‌ها صادر می‌شود (این کار برای استقرار تولید توصیه نمی‌شود). برای مشاهده فهرست فیلدها، PlaceResult را ببینید. فیلدهای تودرتو را می‌توان با مسیرهای نقطه‌ای (برای مثال، "geometry.location") مشخص کرد. پیش‌فرض ['ALL'] است.
placeIdOnly optional
نوع:  boolean optional
آیا فقط «شناسه‌های مکان» بازیابی شود. ‫PlaceResult که هنگام فعال شدن رویداد place_changed دردسترس قرار می‌گیرد، فقط فیلدهای place_id، types، و name را خواهد داشت و place_id، types، و description توسط سرویس «تکمیل خودکار» برگردانده می‌شود. به‌طور پیش‌فرض غیرفعال است.
strictBounds optional
نوع:  boolean optional
مقدار بولی که نشان می‌دهد ابزاره «تکمیل خودکار» باید فقط مکان‌هایی را برگرداند که در زمان ارسال پُرسمان در محدوده ابزاره «تکمیل خودکار» قرار دارند. تنظیم strictBounds روی false (که پیش‌فرض است) باعث می‌شود نتایج به مکان‌های موجود در محدوده متمایل شوند، اما به آن‌ها محدود نشوند.
types optional
نوع:  Array<string> optional
انواع پیش‌بینی‌هایی که باید برگردانده شود. برای انواع پشتیبانی‌شده، راهنمای توسعه‌دهنده را ببینید. اگر نوعی مشخص نشده باشد، همه انواع برگردانده خواهد شد.

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

ابزارکی که پیش‌بینی‌های پُرسمان را براساس ورودی نوشتاری کاربر ارائه می‌دهد. این ویژگی به عنصر ورودی از نوع text متصل می‌شود و به ورودی نوشتاری در آن فیلد گوش می‌دهد. فهرست پیش‌بینی‌ها به‌صورت فهرست کرکره‌ای ارائه می‌شود و با وارد کردن نوشتار به‌روز می‌شود.

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

با تماس با const {SearchBox} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
SearchBox
SearchBox(inputField[, opts])
پارامترها: 
نمونه جدیدی از SearchBox ایجاد می‌کند که با گزینه‌های ارائه‌شده به فیلد نوشتار ورودی مشخص‌شده پیوست می‌شود.
getBounds
getBounds()
پارامترها:  هیچ
مقدار برگشتی:  LatLngBounds|undefined
مرزهایی را که پیش‌بینی‌های پُرسمان به آن‌ها سوگیری دارند برمی‌گرداند.
getPlaces
getPlaces()
پارامترها:  هیچ
مقدار برگشتی:  Array<PlaceResult>|undefined
پُرسمان انتخاب‌شده توسط کاربر را برای استفاده با رویداد places_changed برمی‌گرداند.
setBounds
setBounds(bounds)
پارامترها: 
مقدار برگشتی:  هیچ
منطقه‌ای را که برای سوگیری پیش‌بینی‌های پُرسمان استفاده می‌شود تنظیم می‌کند. نتایج فقط به این منطقه متمایل خواهد بود و کاملاً به آن محدود نخواهد شد.
به‌ارث‌رسیده: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll
places_changed
function()
متغیرهای مستقل:  هیچ
این رویداد زمانی فعال می‌شود که کاربر پُرسمانی را انتخاب کند، getPlaces باید برای دریافت مکان‌های جدید استفاده شود.

میانای SearchBoxOptions

میانا google.maps.places.SearchBoxOptions

گزینه‌هایی که می‌توان برای شیء SearchBox تنظیم کرد.
bounds optional
منطقه‌ای که پیش‌بینی‌های پُرسمان به آن سوگیری دارد. پیش‌بینی‌ها به سمت پُرسمان‌هایی که این محدوده‌ها را هدف قرار می‌دهند سوگیری دارند، اما به آن‌ها محدود نمی‌شوند.

PlaceContextualElement کلاس

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

ابزاره‌ای که از داده‌واحد بافتی برای نمایش نمای بافتاری پاسخ «پایه‌مندسازی با 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])
پارامترها: 
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

گزینه‌های PlaceContextualElement.
contextToken optional
نوع:  string optional
داده‌واحد بافتی ارائه‌شده توسط پاسخ «پایه‌مندسازی با Google Maps».

PlaceContextualListConfigElement کلاس

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

عنصر اچ‌تی‌ام‌ال که گزینه‌های نمای فهرستی «عنصر زمینه‌ای مکان» را پیکربندی می‌کند.

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

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

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

با تماس با const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
PlaceContextualListConfigElement
PlaceContextualListConfigElement([options])
پارامترها: 
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>
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

گزینه‌های PlaceContextualListConfigElement.
layout optional
نوع:  PlaceContextualListLayout optional
پیش‌فرض: PlaceContextualListLayout.VERTICAL
چیدمان.
mapHidden optional
نوع:  boolean optional
پیش‌فرض: false
اگر نقشه باید پنهان شود، درست است.

ثابت‌های PlaceContextualListLayout

google.maps.places.PlaceContextualListLayout یادآور همیشگی

فهرست چیدمان‌هایی که «عنصر زمینه‌ای مکان» برای نمای فهرستی پشتیبانی می‌کند.

با تماس با const {PlaceContextualListLayout} = await google.maps.importLibrary("places") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
COMPACT چیدمان فهرست فشرده: موارد فهرست به‌صورت پیوندهایی در یک خط ارائه می‌شوند و موارد اضافی در فهرست کرکره‌ای قرار می‌گیرند.
VERTICAL چیدمان فهرست عمودی: موارد فهرست به‌صورت کارت در فهرست عمودی ارائه می‌شوند.