Places Widgets

کلاس 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)
پارامترها:
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
مبدأ محاسبه فاصله. در صورت عدم تعیین فاصله محاسبه نمی شود. ارتفاع، اگر داده شود، در محاسبه استفاده نمی شود.
ویژگی 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 ظاهر می شود.
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-error
function(errorEvent)
استدلال ها:
این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-select
function(placePredictionSelectEvent)
استدلال ها:
این رویداد زمانی فعال می‌شود که کاربر پیش‌بینی مکان را انتخاب کند. شامل یک شی PlacePrediction است که می تواند به یک شی Place تبدیل شود.

رابط PlaceAutocompleteElementOptions

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

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

locationBias optional
نوع: LocationBias optional
locationRestriction optional
نوع: LocationRestriction optional
name optional
نوع: string optional
requestedLanguage optional
نوع: string 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.toPlace آن را به یک Place تبدیل کنید.

کلاس PlaceAutocompleteRequestErrorEvent

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

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

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

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

کلاس PlaceContextualElement

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

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

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

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

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

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

contextToken
نوع: string optional
نشانه زمینه.
ویژگی HTML:
  • <gmp-place-contextual context-token="string"></gmp-place-contextual>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta 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

گزینه‌های PlaceContextualElement .

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

کلاس PlaceContextualListConfigElement

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

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

عنصر سفارشی:
<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 ببینید.

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>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta 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

گزینه های PlaceContextualListConfigElement.

layout optional
نوع: PlaceContextualListLayout optional
طرح. پیش فرض PlaceContextualListLayout.VERTICAL است.
mapHidden optional
نوع: boolean optional
این که آیا نقشه پنهان است. پیش فرض نشان دادن نقشه است (مقدار نادرست).

ثابت های PlaceContextualListLayout

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

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

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

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

کلاس PlaceDetailsElement

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

یک عنصر HTML که جزئیات یک مکان را نمایش می دهد. از متدهای configureFromPlace() یا configureFromLocation() برای تعیین محتوایی که قرار است رندر شود استفاده کنید. برای استفاده از عنصر جزئیات مکان، Places UI Kit API را برای پروژه خود در کنسول Google Cloud فعال کنید.

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

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

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

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

PlaceDetailsElement
PlaceDetailsElement([options])
پارامترها:
place
نوع: Place optional
فقط بخوانید. شی Place حاوی شناسه، مکان، و نمای مکان رندر شده فعلی است.
size
نوع: PlaceDetailsSize optional
نوع اندازه PlaceDetailsElement. به طور پیش فرض، عنصر PlaceDetailsSize.X_LARGE نمایش می دهد.
ویژگی HTML:
  • <gmp-place-details size="small"></gmp-place-details>
  • <gmp-place-details size="medium"></gmp-place-details>
  • <gmp-place-details size="large"></gmp-place-details>
  • <gmp-place-details size="x-large"></gmp-place-details>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
configureFromLocation
configureFromLocation(location)
پارامترها:
Return Value: Promise <void> قولی که پس از بارگیری و ارائه داده های مکان برطرف می شود.
ویجت را از یک LatLng با استفاده از کدگذاری جغرافیایی معکوس پیکربندی می کند.
configureFromPlace
configureFromPlace(place)
پارامترها:
  • place : Place |{id:string} مکانی برای رندر کردن جزئیات.
Return Value: Promise <void> قولی که پس از بارگیری و ارائه داده های مکان برطرف می شود.
ویجت را از یک شی Place یا شناسه مکان پیکربندی می کند.
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-load
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که عنصر محتوای خود را بارگذاری و ارائه می کند. این رویداد حباب نمی کند.
gmp-requesterror
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.

رابط PlaceDetailsElementOptions

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

گزینه‌های PlaceDetailsElement .

size optional
نوع: PlaceDetailsSize optional
PlaceDetailsElement.size را ببینید

ثابت های PlaceDetailsSize

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

انواع اندازه برای PlaceDetailsElement .

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

LARGE نوع بزرگ شامل یک تصویر بزرگ، اطلاعات اولیه و اطلاعات تماس.
MEDIUM نوع متوسط ​​شامل یک تصویر بزرگ و اطلاعات اولیه.
SMALL نوع کوچک شامل یک تصویر کوچک و اطلاعات اولیه.
X_LARGE نوع بسیار بزرگ شامل کلاژ عکس، نظرات، و اطلاعات جامع مکان.

کلاس PlaceDetailsCompactElement

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

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

برای استفاده از این عنصر، 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-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
رنگ متن تعاملی و نمادها در برابر رنگ سطح. برای تعداد مرورها و پیوندها در گفتگوی اسناد استفاده می شود.
--gmp-mat-color-secondary-container
رنگ پرکننده کمتر در برابر سطح، برای اجزای مغلوب مانند دکمه های تونال. برای پس‌زمینه دکمه «باز کردن در نقشه‌ها» استفاده می‌شود.
--gmp-mat-color-surface
رنگ برای پس زمینه برای پس‌زمینه عنصر و گفتگوی اسناد استفاده می‌شود.
--gmp-mat-font-body-medium
برای متن اصلی در گفتگوی اسناد استفاده می شود.
--gmp-mat-font-body-small
برای آدرس مکان، رتبه بندی، نوع، قیمت و وضعیت اکنون باز استفاده می شود.
--gmp-mat-font-family
خانواده فونت پایه برای تمام متن ها استفاده می شود.
--gmp-mat-font-headline-medium
برای عنوان متن در گفتگوی اسناد استفاده می شود.
--gmp-mat-font-label-large
برای دکمه "باز کردن در نقشه ها" و پیوندهای موجود در گفتگوی انتساب استفاده می شود.
--gmp-mat-font-title-small
برای نام مکان استفاده می شود.
background-color
رنگ پس‌زمینه عنصر را لغو می‌کند.
border
مرز عنصر را لغو می کند.
border-radius
شعاع مرزی عنصر را لغو می کند.
color-scheme
نشان می دهد که این عنصر در کدام طرح رنگی می تواند رندر شود. برای جزئیات بیشتر به مستندات color-scheme مراجعه کنید. پیش‌فرض‌های color-scheme: light dark .
font-size
تمام متن ها و نمادهای موجود در عنصر را که به صورت داخلی در ems تعریف شده اند، مقیاس می کند. پیش‌فرض 16px است.
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-error
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.
gmp-load
function(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

یک عنصر Compact جزئیات مکان را برای بارگیری داده ها بر اساس یک شی مکان، شناسه یا نام منبع پیکربندی می کند. این عنصر را به عنوان فرزند یک PlaceDetailsCompactElement اضافه کنید تا داده ها را برای مکان مشخص شده بارگیری کنید.

عنصر سفارشی:
<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
شی مکان، شناسه یا نام منبع برای ارائه جزئیات در عنصر Place Details Compact. این ویژگی به عنوان یک نام منبع به ویژگی منعکس می شود.
ویژگی HTML:
  • <gmp-place-details-place-request place="some-place-id"></gmp-place-details-place-request>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta 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 را ببینید

کلاس PlaceContentConfigElement

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

محتوا را پیکربندی می‌کند تا با عنصر Compact جزئیات مکان نشان داده شود. این عنصر را به عنوان فرزند PlaceDetailsCompactElement اضافه کنید تا از آن استفاده کنید. هر یک از عناصر زیر را به PlaceContentConfigElement اضافه کنید تا محتوای مربوطه را نشان دهید:
PlaceMediaElement , PlaceAddressElement , PlaceRatingElement , PlaceTypeElement , PlacePriceElement , PlaceAccessibleEntranceIconElement , PlaceOpenNowStatusElement , PlaceAttributionElement
ترتیب بچه ها مهم نیست. این عنصر محتوا را به ترتیب استاندارد ارائه می کند که قابل تنظیم نیست.

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

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

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

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

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

رابط PlaceContentConfigElementOptions

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

گزینه های PlaceContentConfigElement .

کلاس PlaceMediaElement

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

یک عنصر Compact جزئیات مکان را برای نمایش رسانه یک مکان، مانند عکس‌ها، پیکربندی می‌کند. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

PlaceMediaElement
PlaceMediaElement([options])
پارامترها:
lightboxPreferred
نوع: boolean optional
پیش فرض: false
در مواردی که هر دو گزینه پشتیبانی می شود، لایت باکس رسانه فعال یا غیرفعال شود.
ویژگی HTML:
  • <gmp-place-media lightbox-preferred></gmp-place-media>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceMediaElementOptions

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

گزینه های PlaceMediaElement .

lightboxPreferred optional
نوع: boolean optional
PlaceMediaElement.lightboxPreferred ببینید.

کلاس PlaceAddressElement

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

یک عنصر Compact جزئیات مکان را برای نشان دادن آدرس مکان پیکربندی می کند. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlaceAddressElementOptions

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

گزینه‌های PlaceAddressElement .

کلاس PlaceRatingElement

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

یک عنصر Compact جزئیات مکان را برای نشان دادن رتبه یک مکان پیکربندی می کند. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlaceRatingElementOptions

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

گزینه هایی برای PlaceRatingElement .

کلاس PlaceTypeElement

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

یک عنصر Compact جزئیات مکان را برای نشان دادن نوع مکان پیکربندی می کند. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlaceTypeElementOptions

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

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

کلاس PlacePriceElement

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

یک عنصر Compact جزئیات مکان را برای نشان دادن سطح قیمت یا محدوده قیمت مکان پیکربندی می‌کند. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlacePriceElementOptions

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

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

کلاس PlaceAccessibleEntranceIconElement

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

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

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

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

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

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

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

رابط PlaceAccessibleEntranceIconElementOptions

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

گزینه‌های PlaceAccessibleEntranceIconElement .

کلاس PlaceOpenNowStatusElement

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

یک عنصر Compact جزئیات مکان را برای نمایش وضعیت باز یا بسته فعلی یک مکان پیکربندی می کند. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlaceOpenNowStatusElementOptions

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

گزینه‌های PlaceOpenNowStatusElement .

کلاس PlaceAttributionElement

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

به سفارشی‌سازی متن ارجاع Google Maps در یک عنصر Compact جزئیات مکان اجازه می‌دهد. این عنصر را به عنوان فرزند یک PlaceContentConfigElement اضافه کنید تا از آن استفاده کنید. اگر این عنصر حذف شود، انتساب همچنان با رنگ های پیش فرض نشان داده می شود.

عنصر سفارشی:
<gmp-place-attribution dark-scheme-color="white" light-scheme-color="white"></gmp-place-attribution>

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

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

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

PlaceAttributionElement
PlaceAttributionElement([options])
پارامترها:
darkSchemeColor
نوع: AttributionColor optional
پیش‌فرض: AttributionColor.WHITE
رنگ انتساب نقشه های گوگل در حالت تاریک.
ویژگی HTML:
  • <gmp-place-attribution dark-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution dark-scheme-color="gray"></gmp-place-attribution>
lightSchemeColor
نوع: AttributionColor optional
پیش‌فرض: AttributionColor.GRAY
رنگ تخصیص نقشه های گوگل در حالت نور.
ویژگی HTML:
  • <gmp-place-attribution light-scheme-color="white"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="black"></gmp-place-attribution>
  • <gmp-place-attribution light-scheme-color="gray"></gmp-place-attribution>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.

رابط PlaceAttributionElementOptions

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

گزینه‌های PlaceAttributionElement .

darkSchemeColor optional
نوع: AttributionColor optional
PlaceAttributionElement.darkSchemeColor را ببینید.
lightSchemeColor optional
نوع: AttributionColor optional
PlaceAttributionElement.lightSchemeColor را ببینید.

ثابت های AttributionColor

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

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

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

BLACK متن انتساب مشکی.
GRAY متن انتساب خاکستری.
WHITE متن انتساب سفید.

کلاس PlaceAllContentElement

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

یک عنصر Compact جزئیات مکان را برای نمایش تمام محتوای موجود پیکربندی می کند. این عنصر را به عنوان فرزند PlaceDetailsCompactElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlaceAllContentElementOptions

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

گزینه‌های PlaceAllContentElement .

کلاس PlaceStandardContentElement

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

یک عنصر Compact جزئیات مکان را برای نمایش مجموعه استانداردی از محتوا (رسانه، رتبه بندی، نوع، قیمت، نماد ورودی قابل دسترسی و وضعیت باز کردن اکنون) پیکربندی می کند. این عنصر را به عنوان فرزند PlaceDetailsCompactElement اضافه کنید تا از آن استفاده کنید.

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

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

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

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

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

رابط PlaceStandardContentElementOptions

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

گزینه‌های PlaceStandardContentElement .

کلاس PlaceListElement

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

یک عنصر HTML که نتایج جستجوی مکان را در یک لیست نمایش می دهد. از متدهای configureFromSearchByTextRequest() یا configureFromSearchNearbyRequest() برای تعیین درخواست ارائه نتایج برای آن استفاده کنید. برای استفاده از عنصر فهرست مکان، Places UI Kit API را برای پروژه خود در کنسول Google Cloud فعال کنید.

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

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

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

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

PlaceListElement
PlaceListElement([options])
پارامترها:
places
نوع: Array < Place >
فقط بخوانید. آرایه از اشیاء Place حاوی شناسه‌ها، مکان‌ها و درگاه‌های نمایش مکان‌های ارائه‌شده در حال حاضر.
selectable
نوع: boolean
آیا موارد فهرست قابل انتخاب هستند یا نه. اگر درست باشد، آیتم‌های فهرست دکمه‌هایی خواهند بود که هنگام کلیک کردن، رویداد gmp-placeselect را ارسال می‌کنند. پیمایش و انتخاب صفحه کلید قابل دسترس نیز پشتیبانی می شود.
ویژگی HTML:
  • <gmp-place-list selectable></gmp-place-list>
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط از capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید.
configureFromSearchByTextRequest
configureFromSearchByTextRequest(request)
پارامترها:
  • request : SearchByTextRequest درخواست ارائه نتایج برای. ویژگی fields SearchByTextRequest لازم نیست.
Return Value: Promise <void> قولی که پس از بارگیری و ارائه داده های مکان برطرف می شود.
ویجت را برای ارائه نتایج جستجو از درخواست API جستجوی متن مکان‌ها پیکربندی می‌کند.
configureFromSearchNearbyRequest
configureFromSearchNearbyRequest(request)
پارامترها:
  • request : SearchNearbyRequest درخواست ارائه نتایج برای. ویژگی fields SearchNearbyRequest الزامی نیست.
Return Value: Promise <void> قولی که پس از بارگیری و ارائه داده های مکان برطرف می شود.
ویجت را برای ارائه نتایج جستجو از درخواست API جستجوی مکان‌ها در نزدیکی پیکربندی می‌کند.
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید.
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید.
gmp-load
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که عنصر محتوای خود را بارگذاری و ارائه می کند. این رویداد حباب نمی کند.
gmp-placeselect
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که کاربر مکانی را انتخاب کند. شامل یک شی Place و نمایه مکان انتخاب شده در لیست است.
gmp-requesterror
function(event)
استدلال ها:
این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.

رابط PlaceListElementOptions

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

گزینه‌های PlaceListElement .

selectable optional
نوع: boolean optional
PlaceListElement.selectable را ببینید

کلاس PlaceListPlaceSelectEvent

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

هنگامی که کاربر مکانی را انتخاب می کند، این رویداد توسط PlaceListElement منتشر می شود.

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

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

index
نوع: number
فهرست فهرست مکان انتخاب شده.
place
نوع: Place
یک شی Place حاوی شناسه، مکان، و نمای مکان انتخاب شده.

کلاس تکمیل خودکار

google.maps.places . Autocomplete کلاس 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()
پارامترها: ندارد
Return Value: PlaceResult مکان انتخاب شده توسط کاربر.
اگر جزئیات با موفقیت بازیابی شده باشد، جزئیات مکان انتخاب شده توسط کاربر را برمی گرداند. در غیر این صورت، یک شیء Stub Place را برمی‌گرداند، با ویژگی 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 است و هیچ ویژگی دیگری تعریف نشده است.

رابط خودکار

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
نوع: boolean optional
آیا فقط می توان شناسه های مکان را بازیابی کرد. Placeresult که در صورت اخراج رویداد place_changed در دسترس است ، فقط دارای قسمت های place_id ، انواع و نام ، با مکان_id ، انواع و توضیحات توسط سرویس خودکار است. به طور پیش فرض غیرفعال است.
strictBounds optional
نوع: boolean optional
یک مقدار بولی ، نشان می دهد که ویجت اتوماتیک فقط باید مکانهایی را که در محدوده ویجت خودکار در زمان ارسال پرس و جو قرار دارند ، برگرداند. تنظیم سختگیرانه به false (که پیش فرض است) باعث می شود که نتایج به سمت مکانهای موجود در محدوده ، اما محدود به آن نباشد.
types optional
نوع: Array <string> optional
انواع پیش بینی ها باید برگردانده شوند. برای انواع پشتیبانی شده ، به راهنمای توسعه دهنده مراجعه کنید. در صورت عدم مشخص شدن انواع ، همه نوع بازگردانده می شود.

google.maps.places . SearchBox کلاس 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 رابط google.maps.places . SearchBoxOptions

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

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