Places UI Kit : یک کتابخانه آماده برای استفاده که فضایی را برای سفارشی‌سازی و توسعه کم کد فراهم می‌کند. آن را امتحان کنید و نظرات خود را در مورد تجربه کیت UI خود به اشتراک بگذارید.

‫Google برای ترجمه محتوا به زبان ترجیحی شما از فناوری هوشواره استفاده می‌کند. ترجمه‌های هوشواره‌ای ممکن است اشتباه داشته باشند.

Places Widgets

PlaceAutocompleteElement class

class google.maps.places.PlaceAutocompleteElement extends HTMLElement implements PlaceAutocompleteElementOptions
library "places"

‫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
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-place-autocomplete>

const {PlaceAutocompleteElement} = await google.maps.importLibrary("places");

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

مشخصات
`description` attr: description	نوع: `string optional` شرحی که برای عنصر ورودی استفاده می‌شود. وقتی عنصر ورودی متمرکز باشد، صفحه‌خوان‌ها این را تشخیص خواهند داد. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby مراجعه کنید. مشخصه HTML: `description="string"`
`disabled` attr: disabled	نوع ورودی: `boolean optional` نوع خروجی: `boolean` نشان می‌دهد عنصر ورودی غیرفعال است یا نه. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled مراجعه کنید. مشخصه HTML: `disabled`
`futureOpeningBusinessesIncluded` attr: future-opening-businesses-included	نوع: `boolean optional` اینکه مکان‌هایی که هنوز باز نشده‌اند اما انتظار می‌رود در آینده باز شوند گنجانده شوند یا نه. مشخصه HTML: `future-opening-businesses-included`
`includedPrimaryTypes` attr: included-primary-types	نوع: `Array<string> optional` نوع مکان اصلی گنجانده‌شده (برای مثال، «رستوران» یا «پمپ بنزین»). «مکان» فقط درصورتی برگردانده می‌شود که نوع اصلی آن در این فهرست گنجانده شده باشد. حداکثر ۵ مقدار را می‌توان مشخص کرد. اگر هیچ نوعی مشخص نشده باشد، همه انواع «مکان» برگردانده می‌شود. مشخصه HTML: `included-primary-types="type1 type2 type3..."`
`includedRegionCodes` مشخصه: included-region-codes	نوع: `Array<string> optional` فقط نتایج را در مناطق مشخص‌شده، که حداکثر با ۱۵ کد منطقه دوحرفی CLDR مشخص شده‌اند، لحاظ کنید. مجموعه خالی نتایج را محدود نخواهد کرد. اگر هم `locationRestriction` و هم `includedRegionCodes` تنظیم شده باشد، نتایج در منطقه تقاطع قرار خواهد گرفت. مشخصه HTML: `included-region-codes="c1 c2 c3..."`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`locationBias`	نوع: `LocationBias optional` مرز یا راهنمایی ملایم برای استفاده هنگام جستجوی مکان‌ها.
`locationRestriction`	نوع: `LocationRestriction optional` محدوده‌هایی برای محدود کردن نتایج جستجو.
`maxlength` attr: maxlength	نوع: `number optional` حداکثر تعداد نویسه‌هایی که کاربر می‌تواند وارد کند. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength مراجعه کنید. مشخصه HTML: `maxlength="number"`
`name` attr: 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: `name="string"`
`noClearButton` attr: no-clear-button	نوع ورودی: `boolean optional` نوع خروجی: `boolean` آیا دکمه پاک کردن پنهان شود یا نه. مشخصه HTML: `no-clear-button`
`noInputIcon` attr: no-input-icon	نوع ورودی: `boolean optional` نوع خروجی: `boolean` تعیین می‌کند که نماد ورودی پنهان شود یا نه. مشخصه HTML: `no-input-icon`
`origin` مشخصه: مبدأ	نوع ورودی: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` نوع خروجی: `LatLngAltitude optional` مبدأی که فاصله از آن محاسبه می‌شود. اگر مشخص نشده باشد، فاصله محاسبه نمی‌شود. ارتفاع، درصورت ارائه، در محاسبه استفاده نمی‌شود. مشخصه HTML: `origin="lat,lng"` `origin="lat,lng,altitude"`
`placeholder` attr: placeholder	نوع: `string optional` نوشتار جای‌بان برای استفاده در عنصر ورودی. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder مراجعه کنید. مشخصه HTML: `placeholder="string"`
`pureServiceAreaBusinessesIncluded` attr: pure-service-area-businesses-included	نوع: `boolean optional` اینکه مکان‌هایی که صرفاً کسب‌وکارهای با منطقه خدماتی هستند گنجانده شوند یا نه. مشخصه HTML: `pure-service-area-businesses-included`
`readonly` attr: readonly	نوع ورودی: `boolean optional` نوع خروجی: `boolean` آیا عنصر ورودی فقط خواندنی است. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly مراجعه کنید. مشخصه HTML: `readonly`
`requestedLanguage` attr: requested-language	نوع: `string optional` شناسه زبان برای زبانی که نتایج باید به آن زبان برگردانده شود (درصورت امکان). نتایج به زبان انتخابی ممکن است رتبه بالاتری داشته باشند، اما پیشنهادها به این زبان محدود نمی‌شوند. فهرست زبان‌های پشتیبانی‌شده را ببینید. مشخصه HTML: `requested-language="string"`
`requestedRegion` attr: requested-region	نوع: `string optional` کد منطقه‌ای که برای قالب‌بندی نتیجه و فیلتر کردن نتیجه استفاده می‌شود. این گزینه پیشنهادها را به این کشور محدود نمی‌کند. کد منطقه مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») را می‌پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، دامنه سطح بالای کد کشوری پادشاهی متحد «uk» (`.co.uk`) است، درحالی‌که کد ISO 3166-1 آن «gb» است (که ازنظر فنی برای نهاد «پادشاهی متحد بریتانیای کبیر و ایرلند شمالی» است). مشخصه HTML: `requested-region="string"`
`unitSystem` attr: unit-system	نوع ورودی: `UnitSystem optional` نوع خروجی: `UnitSystem optional` سیستم واحدی که برای نمایش مسافت‌ها استفاده می‌شود. اگر مشخص نشده باشد، سیستم واحد توسط requestedRegion تعیین می‌شود. مشخصه HTML: `unit-system="value-name"`
`value`	نوع ورودی: `string optional` نوع خروجی: `string` مقدار عنصر ورودی.

ماشین سکه‌ای
`clear-icon`	عنصر شکاف‌دار را در جایگاه نماد پاک کردن قرار می‌دهد. وقتی نوشتاری در ورودی وجود داشته باشد، دکمه پاک کردن در انتهای چارگوش ورودی نمایش داده می‌شود.
`input-icon`	عنصر شکاف‌دار را در موقعیت نماد ورودی قرار می‌دهد. نماد ورودی در ابتدای چارگوش ورودی در حالت درون‌خطی نمایش داده می‌شود.
`prediction-item-icon`	این جایگاه دقیقاً یک عنصر `<template>` را می‌پذیرد تا به‌عنوان نماد نشان‌داده‌شده در کنار مورد پیش‌بینی ارائه شود.

قطعات
`focus-ring`	عنصری که برای نمایش حلقه تمرکز در اطراف عنصر متمرکزشده (ورودی یا موارد پیش‌بینی) استفاده می‌شود
`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-main-text برجسته می‌شود.
`prediction-item-nonmatch`	بخشی از متن اصلی پیش‌بینی که با ورودی کاربر مطابقت ندارد.
`prediction-item-secondary-text`	بخشی از مورد پیش‌بینی که نوشتار ثانویه پیش‌بینی است. نوشتار اضافی معمولاً نشانی است.
`prediction-item-selected`	موردی که کاربر ازطریق صفحه‌کلید به آن پیمایش می‌کند. توجه: موارد انتخاب‌شده هم تحت‌تأثیر سبک‌های این بخش و هم سبک‌های بخش مورد پیش‌بینی قرار می‌گیرند.
`prediction-list`	عنصر دیداری حاوی فهرست پیش‌بینی‌های برگردانده‌شده توسط سرویس «تکمیل خودکار جا». این فهرست به‌صورت فهرست کرکره‌ای در زیر PlaceAutocompleteElement نشان داده می‌شود.

دارایی‌های CSS
`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`، `removeEventListener`

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

میانای PlaceAutocompleteElementOptions

میانا google.maps.places.PlaceAutocompleteElementOptions
پیاده‌سازی‌شده توسط PlaceAutocompleteElement

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

مشخصات
`description` اختیاری	نوع: `string optional` شرحی که برای عنصر ورودی استفاده می‌شود. وقتی عنصر ورودی متمرکز باشد، صفحه‌خوان‌ها این را تشخیص خواهند داد.
`disabled` اختیاری	نوع: `boolean optional`
`futureOpeningBusinessesIncluded` اختیاری	نوع: `boolean optional`
`includedPrimaryTypes` اختیاری	نوع: `Array<string> optional`
`includedRegionCodes` اختیاری	نوع: `Array<string> optional`
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional`
`locationBias` اختیاری	نوع: `LocationBias optional`
`locationRestriction` اختیاری	نوع: `LocationRestriction optional`
`maxlength` اختیاری	نوع: `number optional`
`name` اختیاری	نوع: `string optional`
`noClearButton` اختیاری	نوع: `boolean optional`
`noInputIcon` اختیاری	نوع: `boolean optional`
`origin` اختیاری	نوع: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`placeholder` اختیاری	نوع: `string optional`
`pureServiceAreaBusinessesIncluded` اختیاری	نوع: `boolean optional`
`readonly` اختیاری	نوع: `boolean optional`
`requestedLanguage` اختیاری	نوع: `string optional`
`requestedRegion` اختیاری	نوع: `string optional`
`unitSystem` اختیاری	نوع: `UnitSystem optional`
`value` اختیاری	نوع: `string optional` مقدار عنصر ورودی.

کلاس PlacePredictionSelectEvent

class google.maps.places.PlacePredictionSelectEvent extends Event
library "places"

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

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

const {PlacePredictionSelectEvent} = await google.maps.importLibrary("places");

مشخصات
`placePrediction` readonly	نوع: `PlacePrediction` با تماس با `PlacePrediction.toPlace`، این را به `Place` تبدیل کنید.

کلاس BasicPlaceAutocompleteElement

class google.maps.places.BasicPlaceAutocompleteElement extends HTMLElement implements BasicPlaceAutocompleteElementOptions
library "places"

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

<gmp-basic-place-autocomplete
  description="string"
  disabled
  future-opening-businesses-included
  included-primary-types="type1 type2 type3..."
  included-region-codes="c1 c2 c3..."
  internal-usage-attribution-ids="space separated strings"
  maxlength="number"
  name="string"
  no-clear-button
  no-input-icon
  origin="lat,lng"
  placeholder="string"
  pure-service-area-businesses-included
  readonly
  requested-language="string"
  requested-region="string"
  unit-system="value-name">
</gmp-basic-place-autocomplete>

const {BasicPlaceAutocompleteElement} = await google.maps.importLibrary("places");

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

مشخصات
`description` attr: description	نوع: `string optional` شرحی که برای عنصر ورودی استفاده می‌شود. وقتی عنصر ورودی متمرکز باشد، صفحه‌خوان‌ها این را تشخیص خواهند داد. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/Accessibility/ARIA/Reference/Attributes/aria-describedby مراجعه کنید. مشخصه HTML: `description="string"`
`disabled` attr: disabled	نوع ورودی: `boolean optional` نوع خروجی: `boolean` نشان می‌دهد عنصر ورودی غیرفعال است یا نه. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#disabled مراجعه کنید. مشخصه HTML: `disabled`
`futureOpeningBusinessesIncluded` attr: future-opening-businesses-included	نوع: `boolean optional` اینکه مکان‌هایی که هنوز باز نشده‌اند اما انتظار می‌رود در آینده باز شوند گنجانده شوند یا نه. مشخصه HTML: `future-opening-businesses-included`
`includedPrimaryTypes` attr: included-primary-types	نوع: `Array<string> optional` نوع مکان اصلی گنجانده‌شده (برای مثال، «رستوران» یا «پمپ بنزین»). «مکان» فقط درصورتی برگردانده می‌شود که نوع اصلی آن در این فهرست گنجانده شده باشد. حداکثر ۵ مقدار را می‌توان مشخص کرد. اگر هیچ نوعی مشخص نشده باشد، همه انواع «مکان» برگردانده می‌شود. مشخصه HTML: `included-primary-types="type1 type2 type3..."`
`includedRegionCodes` مشخصه: included-region-codes	نوع: `Array<string> optional` فقط نتایج را در مناطق مشخص‌شده، که حداکثر با ۱۵ کد منطقه دوحرفی CLDR مشخص شده‌اند، لحاظ کنید. مجموعه خالی نتایج را محدود نخواهد کرد. اگر هم `locationRestriction` و هم `includedRegionCodes` تنظیم شده باشد، نتایج در منطقه تقاطع قرار خواهد گرفت. مشخصه HTML: `included-region-codes="c1 c2 c3..."`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`locationBias`	نوع: `LocationBias optional` مرز یا راهنمایی ملایم برای استفاده هنگام جستجوی مکان‌ها.
`locationRestriction`	نوع: `LocationRestriction optional` محدوده‌هایی برای محدود کردن نتایج جستجو.
`maxlength` attr: maxlength	نوع: `number optional` حداکثر تعداد نویسه‌هایی که کاربر می‌تواند وارد کند. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#maxlength مراجعه کنید. مشخصه HTML: `maxlength="number"`
`name` attr: 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: `name="string"`
`noClearButton` attr: no-clear-button	نوع ورودی: `boolean optional` نوع خروجی: `boolean` آیا دکمه پاک کردن پنهان شود یا نه. مشخصه HTML: `no-clear-button`
`noInputIcon` attr: no-input-icon	نوع ورودی: `boolean optional` نوع خروجی: `boolean` تعیین می‌کند که نماد ورودی پنهان شود یا نه. مشخصه HTML: `no-input-icon`
`origin` مشخصه: مبدأ	نوع ورودی: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` نوع خروجی: `LatLngAltitude optional` مبدأی که فاصله از آن محاسبه می‌شود. اگر مشخص نشده باشد، فاصله محاسبه نمی‌شود. ارتفاع، درصورت ارائه، در محاسبه استفاده نمی‌شود. مشخصه HTML: `origin="lat,lng"` `origin="lat,lng,altitude"`
`placeholder` attr: placeholder	نوع: `string optional` نوشتار جای‌بان برای استفاده در عنصر ورودی. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#placeholder مراجعه کنید. مشخصه HTML: `placeholder="string"`
`pureServiceAreaBusinessesIncluded` attr: pure-service-area-businesses-included	نوع: `boolean optional` اینکه مکان‌هایی که صرفاً کسب‌وکارهای با منطقه خدماتی هستند گنجانده شوند یا نه. مشخصه HTML: `pure-service-area-businesses-included`
`readonly` attr: readonly	نوع ورودی: `boolean optional` نوع خروجی: `boolean` آیا عنصر ورودی فقط خواندنی است. برای جزئیات، به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#readonly مراجعه کنید. مشخصه HTML: `readonly`
`requestedLanguage` attr: requested-language	نوع: `string optional` شناسه زبان برای زبانی که نتایج باید به آن زبان برگردانده شود (درصورت امکان). نتایج به زبان انتخابی ممکن است رتبه بالاتری داشته باشند، اما پیشنهادها به این زبان محدود نمی‌شوند. فهرست زبان‌های پشتیبانی‌شده را ببینید. مشخصه HTML: `requested-language="string"`
`requestedRegion` attr: requested-region	نوع: `string optional` کد منطقه‌ای که برای قالب‌بندی نتیجه و فیلتر کردن نتیجه استفاده می‌شود. این گزینه پیشنهادها را به این کشور محدود نمی‌کند. کد منطقه مقدار دو نویسه‌ای ccTLD («دامنه سطح بالا») را می‌پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با چند استثنای قابل‌توجه. برای مثال، دامنه سطح بالای کد کشوری پادشاهی متحد «uk» (`.co.uk`) است، درحالی‌که کد ISO 3166-1 آن «gb» است (که ازنظر فنی برای نهاد «پادشاهی متحد بریتانیای کبیر و ایرلند شمالی» است). مشخصه HTML: `requested-region="string"`
`unitSystem` attr: unit-system	نوع ورودی: `UnitSystem optional` نوع خروجی: `UnitSystem optional` سیستم واحدی که برای نمایش مسافت‌ها استفاده می‌شود. اگر مشخص نشده باشد، سیستم واحد توسط requestedRegion تعیین می‌شود. مشخصه HTML: `unit-system="value-name"`

ماشین سکه‌ای
`clear-icon`	عنصر شکاف‌دار را در جایگاه نماد پاک کردن قرار می‌دهد. وقتی نوشتاری در ورودی وجود داشته باشد، دکمه پاک کردن در انتهای چارگوش ورودی نمایش داده می‌شود.
`input-icon`	عنصر شکاف‌دار را در موقعیت نماد ورودی قرار می‌دهد. نماد ورودی در ابتدای چارگوش ورودی در حالت درون‌خطی نمایش داده می‌شود.
`prediction-item-icon`	این جایگاه دقیقاً یک عنصر `<template>` را می‌پذیرد تا به‌عنوان نماد نشان‌داده‌شده در کنار مورد پیش‌بینی ارائه شود.

قطعات
`focus-ring`	عنصری که برای نمایش حلقه تمرکز در اطراف عنصر متمرکزشده (ورودی یا موارد پیش‌بینی) استفاده می‌شود
`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-main-text برجسته می‌شود.
`prediction-item-nonmatch`	بخشی از متن اصلی پیش‌بینی که با ورودی کاربر مطابقت ندارد.
`prediction-item-secondary-text`	بخشی از مورد پیش‌بینی که نوشتار ثانویه پیش‌بینی است. نوشتار اضافی معمولاً نشانی است.
`prediction-item-selected`	موردی که کاربر ازطریق صفحه‌کلید به آن پیمایش می‌کند. توجه: موارد انتخاب‌شده هم تحت‌تأثیر سبک‌های این بخش و هم سبک‌های بخش مورد پیش‌بینی قرار می‌گیرند.
`prediction-list`	عنصر دیداری حاوی فهرست پیش‌بینی‌های برگردانده‌شده توسط سرویس «تکمیل خودکار جا». این فهرست به‌صورت فهرست کرکره‌ای در زیر PlaceAutocompleteElement نشان داده می‌شود.

دارایی‌های CSS
`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`، `removeEventListener`

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

میانای BasicPlaceAutocompleteElementOptions

میانا google.maps.places.BasicPlaceAutocompleteElementOptions
پیاده‌سازی‌شده توسط BasicPlaceAutocompleteElement

گزینه‌های ساخت BasicPlaceAutocompleteElement.

مشخصات
`description` اختیاری	نوع: `string optional` شرحی که برای عنصر ورودی استفاده می‌شود. وقتی عنصر ورودی متمرکز باشد، صفحه‌خوان‌ها این را تشخیص خواهند داد.
`disabled` اختیاری	نوع: `boolean optional`
`futureOpeningBusinessesIncluded` اختیاری	نوع: `boolean optional`
`includedPrimaryTypes` اختیاری	نوع: `Array<string> optional`
`includedRegionCodes` اختیاری	نوع: `Array<string> optional`
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional`
`locationBias` اختیاری	نوع: `LocationBias optional`
`locationRestriction` اختیاری	نوع: `LocationRestriction optional`
`maxlength` اختیاری	نوع: `number optional`
`name` اختیاری	نوع: `string optional`
`noClearButton` اختیاری	نوع: `boolean optional`
`noInputIcon` اختیاری	نوع: `boolean optional`
`origin` اختیاری	نوع: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional`
`placeholder` اختیاری	نوع: `string optional`
`pureServiceAreaBusinessesIncluded` اختیاری	نوع: `boolean optional`
`readonly` اختیاری	نوع: `boolean optional`
`requestedLanguage` اختیاری	نوع: `string optional`
`requestedRegion` اختیاری	نوع: `string optional`
`unitSystem` اختیاری	نوع: `UnitSystem optional`

کلاس PlaceDetailsElement

کلاس google.maps.places.PlaceDetailsElement HTMLElement را گسترش می‌دهد PlaceDetailsElementOptions را پیاده‌سازی می‌کند
توسط AdvancedPlaceDetailsElement گسترش یافته است
کتابخانه "places"

جزئیات مکانی را در چیدمان کامل نمایش می‌دهد. برای مشخص کردن مکانی که باید ارائه شود، 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
  internal-usage-attribution-ids="space separated strings">
</gmp-place-details>

const {PlaceDetailsElement} = await google.maps.importLibrary("places");

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

مشخصات
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	نوع: `Place optional` فقط خواندنی. شیء مکان حاوی شناسه، مکان، و نمای هدف مکان ارائه‌شده فعلی.

دارایی‌های CSS
`--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`، `removeEventListener`

رویدادها
`gmp-error`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
`gmp-load`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.

میانای PlaceDetailsElementOptions

میانای google.maps.places.PlaceDetailsElementOptions
گسترش‌یافته توسط AdvancedPlaceDetailsElementOptions
پیاده‌سازی‌شده توسط AdvancedPlaceDetailsElement, PlaceDetailsElement

گزینه‌های PlaceDetailsElement.

مشخصات
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.

کلاس PlaceDetailsCompactElement

کلاس google.maps.places.PlaceDetailsCompactElement HTMLElement را گسترش می‌دهد PlaceDetailsCompactElementOptions را پیاده‌سازی می‌کند
توسط AdvancedPlaceDetailsCompactElement گسترش یافته است
کتابخانه "places"

جزئیات مکانی را در چیدمان فشرده نمایش می‌دهد. برای مشخص کردن مکانی که باید ارائه شود، 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
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  truncation-preferred>
</gmp-place-details-compact>

const {PlaceDetailsCompactElement} = await google.maps.importLibrary("places");

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

مشخصات
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	نوع: `PlaceDetailsOrientation optional` پیش‌فرض: `PlaceDetailsOrientation.VERTICAL` گونه جهت (عمودی یا افقی) عنصر. مشخصه HTML: `orientation="value-name"`
`place` readonly	نوع: `Place optional` فقط خواندنی. شیء مکان حاوی شناسه، مکان، و نمای هدف مکان ارائه‌شده فعلی.
`truncationPreferred` attr: truncation-preferred	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` اگر درست باشد، نام و نشانی مکان را کوتاه می‌کند تا به‌جای پیچیدن در خط بعدی، در یک خط جا شود. مشخصه HTML: `truncation-preferred`

دارایی‌های CSS
`--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`، `removeEventListener`

رویدادها
`gmp-error`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
`gmp-load`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.

میانای PlaceDetailsCompactElementOptions

میانای google.maps.places.PlaceDetailsCompactElementOptions
گسترش‌یافته توسط AdvancedPlaceDetailsCompactElementOptions
پیاده‌سازی‌شده توسط AdvancedPlaceDetailsCompactElement, PlaceDetailsCompactElement

گزینه‌های PlaceDetailsCompactElement.

مشخصات
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.
`orientation` اختیاری	نوع: `PlaceDetailsOrientation optional` `PlaceDetailsCompactElement.orientation` را ببینید.
`truncationPreferred` اختیاری	نوع: `boolean optional` `PlaceDetailsCompactElement.truncationPreferred` را ببینید.

کلاس AdvancedPlaceDetailsElement

class google.maps.places.AdvancedPlaceDetailsElement extends PlaceDetailsElement, HTMLElement implements AdvancedPlaceDetailsElementOptions, PlaceDetailsElementOptions
library "places"

جزئیات مکانی را در چیدمان کامل نمایش می‌دهد. برای مشخص کردن مکانی که باید ارائه شود، PlaceDetailsPlaceRequestElement یا PlaceDetailsLocationRequestElement را اضافه کنید. برای پیکربندی محتوا برای ارائه، PlaceStandardContentElement، PlaceAllContentElement، یا عناصر جزئیات مکان را مستقیماً اضافه کنید.

مثال:

 <gmp-advanced-place-details>
   <gmp-place-details-place-request
     place="PLACE_ID"
   ></gmp-place-details-place-request>
   <gmp-place-standard-content>
   </gmp-place-standard-content>
 </gmp-advanced-place-details>

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

<gmp-advanced-place-details
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details>

const {AdvancedPlaceDetailsElement} = await google.maps.importLibrary("places");

سازنده
`AdvancedPlaceDetailsElement`	`AdvancedPlaceDetailsElement([options])` پارامترها: `options: AdvancedPlaceDetailsElementOptions optional`

مشخصات
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	نوع: `Place optional` فقط خواندنی. شیء مکان حاوی شناسه، مکان، و نمای هدف مکان ارائه‌شده فعلی.

ماشین سکه‌ای
`action-corner`	وقت آزاد برای `PlaceLinkElement` و `PlaceButtonElement`.
`action-main`	وقت آزاد برای `PlaceLinkElement` و `PlaceButtonElement`.
`basic-section-bottom`	توجه: فقط در کانال v=alpha دردسترس است. جایگاهی برای محتوای HTML سفارشی که در پایین بخش اطلاعات پایه، درست زیر دکمه‌های کنش اصلی، ارائه می‌شود.
`basic-section-top`	توجه: فقط در کانال v=alpha دردسترس است. جایگاهی برای محتوای HTML سفارشی که در بخش اطلاعات پایه، مستقیماً بالای نام مکان، ارائه می‌شود.

دارایی‌های CSS
به‌ارث‌رسیده: `--gmp-button-border-color`، `--gmp-button-border-radius`، `--gmp-button-border-width`، `--gmp-collage-border-radius-outer`، `--gmp-dialog-border-radius`، `--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`، `--gmp-mat-color-on-surface`، `--gmp-mat-color-on-surface-variant`، `--gmp-mat-color-outline-decorative`، `--gmp-mat-color-positive`، `--gmp-mat-color-positive-container`، `--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-display-small`، `--gmp-mat-font-family`، `--gmp-mat-font-headline-medium`، `--gmp-mat-font-label-large`، `--gmp-mat-font-label-medium`، `--gmp-mat-font-title-small`، `--gmp-mat-spacing-extra-large`، `--gmp-mat-spacing-extra-small`، `--gmp-mat-spacing-large`، `--gmp-mat-spacing-medium`، `--gmp-mat-spacing-small`، `--gmp-mat-spacing-two-extra-large`، `--gmp-star-rating-color`، `background-color`، `border`، `border-radius`، `color-scheme`، `font-size`

دارایی‌های CSS

به‌ارث‌رسیده: --gmp-button-border-color، --gmp-button-border-radius، --gmp-button-border-width، --gmp-collage-border-radius-outer، --gmp-dialog-border-radius، --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، --gmp-mat-color-on-surface، --gmp-mat-color-on-surface-variant، --gmp-mat-color-outline-decorative، --gmp-mat-color-positive، --gmp-mat-color-positive-container، --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-display-small، --gmp-mat-font-family، --gmp-mat-font-headline-medium، --gmp-mat-font-label-large، --gmp-mat-font-label-medium، --gmp-mat-font-title-small، --gmp-mat-spacing-extra-large، --gmp-mat-spacing-extra-small، --gmp-mat-spacing-large، --gmp-mat-spacing-medium، --gmp-mat-spacing-small، --gmp-mat-spacing-two-extra-large، --gmp-star-rating-color، background-color، border، border-radius، color-scheme، font-size

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

رویدادها
به‌ارث‌رسیده: `gmp-error`، `gmp-load`

میانای AdvancedPlaceDetailsElementOptions

میانای google.maps.places.AdvancedPlaceDetailsElementOptions PlaceDetailsElementOptions را گسترش می‌دهد
توسط AdvancedPlaceDetailsElement پیاده‌سازی شده است

گزینه‌های AdvancedPlaceDetailsElement.

مشخصات
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.

کلاس AdvancedPlaceDetailsCompactElement

class google.maps.places.AdvancedPlaceDetailsCompactElement extends PlaceDetailsCompactElement, HTMLElement implements AdvancedPlaceDetailsCompactElementOptions, PlaceDetailsCompactElementOptions
library "places"

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

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

<gmp-advanced-place-details-compact
  internal-usage-attribution-ids="space separated strings">
</gmp-advanced-place-details-compact>

const {AdvancedPlaceDetailsCompactElement} = await google.maps.importLibrary("places");

سازنده
`AdvancedPlaceDetailsCompactElement`	`AdvancedPlaceDetailsCompactElement([options])` پارامترها: `options: AdvancedPlaceDetailsCompactElementOptions optional`

مشخصات
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`place` readonly	نوع: `Place optional` فقط خواندنی. شیء مکان حاوی شناسه، مکان، و نمای هدف مکان ارائه‌شده فعلی.
به‌ارث‌رسیده: `orientation` (attr: `orientation`)، `truncationPreferred` (attr: `truncation-preferred`)

ماشین سکه‌ای
`action-corner`	وقت آزاد برای `PlaceLinkElement` و `PlaceButtonElement`.
`action-main`	وقت آزاد برای `PlaceLinkElement` و `PlaceButtonElement`.
`basic-section-bottom`	توجه: فقط در کانال v=alpha دردسترس است. جایگاهی برای محتوای HTML سفارشی که در پایین بخش اطلاعات پایه، درست زیر دکمه‌های کنش اصلی، ارائه می‌شود.
`basic-section-top`	توجه: فقط در کانال v=alpha دردسترس است. جایگاهی برای محتوای HTML سفارشی که در بخش اطلاعات پایه، مستقیماً بالای نام مکان، ارائه می‌شود.

دارایی‌های CSS
به‌ارث‌رسیده: `--gmp-button-border-color`، `--gmp-button-border-radius`، `--gmp-button-border-width`، `--gmp-dialog-border-radius`، `--gmp-mat-color-info`، `--gmp-mat-color-negative`، `--gmp-mat-color-neutral-container`، `--gmp-mat-color-on-secondary-container`، `--gmp-mat-color-on-surface`، `--gmp-mat-color-on-surface-variant`، `--gmp-mat-color-outline-decorative`، `--gmp-mat-color-positive`، `--gmp-mat-color-primary`، `--gmp-mat-color-secondary-container`، `--gmp-mat-color-surface`، `--gmp-mat-font-body-medium`، `--gmp-mat-font-body-small`، `--gmp-mat-font-family`، `--gmp-mat-font-headline-medium`، `--gmp-mat-font-label-large`، `--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`، `font-size`

دارایی‌های CSS

به‌ارث‌رسیده: --gmp-button-border-color، --gmp-button-border-radius، --gmp-button-border-width، --gmp-dialog-border-radius، --gmp-mat-color-info، --gmp-mat-color-negative، --gmp-mat-color-neutral-container، --gmp-mat-color-on-secondary-container، --gmp-mat-color-on-surface، --gmp-mat-color-on-surface-variant، --gmp-mat-color-outline-decorative، --gmp-mat-color-positive، --gmp-mat-color-primary، --gmp-mat-color-secondary-container، --gmp-mat-color-surface، --gmp-mat-font-body-medium، --gmp-mat-font-body-small، --gmp-mat-font-family، --gmp-mat-font-headline-medium، --gmp-mat-font-label-large، --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، font-size

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

رویدادها
به‌ارث‌رسیده: `gmp-error`، `gmp-load`

میانای AdvancedPlaceDetailsCompactElementOptions

میانای google.maps.places.AdvancedPlaceDetailsCompactElementOptions PlaceDetailsCompactElementOptions را گسترش می‌دهد
توسط AdvancedPlaceDetailsCompactElement پیاده‌سازی شده است

گزینه‌های AdvancedPlaceDetailsCompactElement.

مشخصات
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.
به‌ارث‌رسیده: `orientation`، `truncationPreferred`

ثابت‌های PlaceDetailsOrientation

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

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

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

const {PlaceDetailsOrientation} = await google.maps.importLibrary("places");

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

کلاس PlaceDetailsPlaceRequestElement

class google.maps.places.PlaceDetailsPlaceRequestElement extends HTMLElement implements PlaceDetailsPlaceRequestElementOptions
library "places"

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="places/###">
</gmp-place-details-place-request>

const {PlaceDetailsPlaceRequestElement} = await google.maps.importLibrary("places");

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

مشخصات
`place` attr: place	نوع ورودی: `Place\|string optional` نوع خروجی: `Place optional` پیش‌فرض: `null` شیء، شناسه، یا نام منبع جا برای ارائه جزئیات در عنصر «جزئیات جا» فشرده. این ویژگی به مشخصه به‌عنوان نام منبع اشاره می‌کند. مشخصه HTML: `place="places/###"`

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceDetailsPlaceRequestElementOptions

میانا google.maps.places.PlaceDetailsPlaceRequestElementOptions
پیاده‌سازی‌شده توسط PlaceDetailsPlaceRequestElement

گزینه‌های PlaceDetailsPlaceRequestElement.

مشخصات
`place` اختیاری	نوع: `Place\|string optional` مشاهده `PlaceDetailsPlaceRequestElement.place`

کلاس PlaceDetailsLocationRequestElement

class google.maps.places.PlaceDetailsLocationRequestElement extends HTMLElement implements PlaceDetailsLocationRequestElementOptions
library "places"

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>

const {PlaceDetailsLocationRequestElement} = await google.maps.importLibrary("places");

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

مشخصات
`location` attr: location	نوع ورودی: `LatLng\|LatLngLiteral\|LatLngAltitude\|LatLngAltitudeLiteral optional` نوع خروجی: `LatLngAltitude optional` پیش‌فرض: `null` مکانی که جزئیات آن در عنصر «جزئیات جا» پرداز می‌شود. به `LatLngAltitude` نرمال‌سازی می‌شود. مشخصه HTML: `location="lat,lng"`

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceDetailsLocationRequestElementOptions

میانا google.maps.places.PlaceDetailsLocationRequestElementOptions
پیاده‌سازی‌شده توسط PlaceDetailsLocationRequestElement

گزینه‌های PlaceDetailsLocationRequestElement.

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

PlaceSearchElement کلاس

کلاس google.maps.places.PlaceSearchElement HTMLElement را گسترش می‌دهد PlaceSearchElementOptions را پیاده‌سازی می‌کند
توسط AdvancedPlaceSearchElement گسترش یافته است
کتابخانه "places"

نتایج جستجوی مکان را در فهرست نمایش می‌دهد. 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="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-place-search>

const {PlaceSearchElement} = await google.maps.importLibrary("places");

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

مشخصات
`attributionPosition` attr: attribution-position	نوع ورودی: `PlaceSearchAttributionPosition optional` نوع خروجی: `PlaceSearchAttributionPosition` پیش‌فرض: `PlaceSearchAttributionPosition.TOP` موقعیت نشان منبع و دکمه شفاف‌سازی قانونی. مشخصه HTML: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	نوع ورودی: `PlaceSearchOrientation optional` نوع خروجی: `PlaceSearchOrientation` پیش‌فرض: `PlaceSearchOrientation.VERTICAL` گونه جهت (عمودی یا افقی) عنصر. مشخصه HTML: `orientation="value-name"`
`places` readonly	نوع: `Array<Place>` فقط خواندنی. آرایه‌ای از اشیاء `Place` حاوی شناسه‌ها، مکان‌ها، و درگاه‌های دید مکان‌های ارائه‌شده فعلی.
`selectable` attr: selectable	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` آیا موارد فهرست قابل‌انتخاب هستند یا نه. اگر درست باشد، موارد فهرست دکمه‌هایی خواهند بود که هنگام کلیک شدن، رویداد `gmp-select` را ارسال می‌کنند. پیمایش و انتخاب با صفحه‌کلید دسترس‌پذیر نیز پشتیبانی می‌شود. مشخصه HTML: `selectable`
`truncationPreferred` attr: truncation-preferred	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` اگر درست باشد، خطوط خاصی از محتوا را کوتاه می‌کند تا به‌جای پیچیدن در یک خط جا شود. مشخصه HTML: `truncation-preferred`

دارایی‌های CSS
`--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`، `removeEventListener`

رویدادها
`gmp-error`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
`gmp-load`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.
`gmp-select`	`function(event)` متغیرهای مستقل: `event: PlaceSelectEvent optional` این رویداد زمانی فعال می‌شود که مکانی از فهرست انتخاب شود. حاوی شیء `Place` است که شامل شناسه، مکان، و نمای دید مکان انتخاب‌شده است.

میانای PlaceSearchElementOptions

میانای google.maps.places.PlaceSearchElementOptions
گسترش‌یافته توسط AdvancedPlaceSearchElementOptions
پیاده‌سازی‌شده توسط AdvancedPlaceSearchElement, PlaceSearchElement

گزینه‌های PlaceSearchElement.

مشخصات
`attributionPosition` اختیاری	نوع: `PlaceSearchAttributionPosition optional` `PlaceSearchElement.attributionPosition` را ببینید.
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.
`orientation` اختیاری	نوع: `PlaceSearchOrientation optional` `PlaceSearchElement.orientation` را ببینید.
`selectable` اختیاری	نوع: `boolean optional` مشاهده `PlaceSearchElement.selectable`
`truncationPreferred` اختیاری	نوع: `boolean optional` `PlaceSearchElement.truncationPreferred` را ببینید.

PlaceItemElement کلاس

کلاس google.maps.places.PlaceItemElement HTMLElement را گسترش می‌دهد PlaceItemElementOptions را پیاده‌سازی می‌کند
توسط AdvancedPlaceItemElement گسترش یافته است
کتابخانه "places"

پوشاننده مؤلفه وب عمومی (<gmp-place-item>) برای موارد فهرست مکان. عنصر سفارشی <gmp-place-item> کارت نتیجه مکان تکی را در <gmp-place-search> ارائه می‌کند. هر <gmp-place-item> اطلاعات مکان را که از مؤلفه‌های دیداری فرزند از «کیت میانای کاربر جاها» تشکیل شده است نمایش می‌دهد.

<gmp-place-item></gmp-place-item>

const {PlaceItemElement} = await google.maps.importLibrary("places");

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceItemElementOptions

میانای google.maps.places.PlaceItemElementOptions
گسترش‌یافته توسط AdvancedPlaceItemElementOptions
پیاده‌سازی‌شده توسط AdvancedPlaceItemElement, PlaceItemElement

گزینه‌های PlaceItemElement.

کلاس AdvancedPlaceSearchElement

class google.maps.places.AdvancedPlaceSearchElement extends PlaceSearchElement, HTMLElement implements AdvancedPlaceSearchElementOptions, PlaceSearchElementOptions
library "places"

نتایج جستجوی پیشرفته مکان را در فهرست نمایش می‌دهد. PlaceTextSearchRequestElement یا PlaceNearbySearchRequestElement را اضافه کنید تا درخواست ارائه نتایج را مشخص کنید. ‫PlaceStandardContentElement،‏ PlaceAllContentElement، یا <template slot="details-item"> را اضافه کنید تا مشخص شود کدام محتوا باید ارائه شود.

مثال:

 <gmp-advanced-place-search>
   <gmp-place-text-search-request
     text-query="QUERY"
   ></gmp-place-text-search-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-search>

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

<gmp-advanced-place-search
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  selectable
  truncation-preferred>
</gmp-advanced-place-search>

const {AdvancedPlaceSearchElement} = await google.maps.importLibrary("places");

سازنده
`AdvancedPlaceSearchElement`	`AdvancedPlaceSearchElement([options])` پارامترها: `options: AdvancedPlaceSearchElementOptions optional`

مشخصات
`attributionPosition` attr: attribution-position	نوع ورودی: `PlaceSearchAttributionPosition optional` نوع خروجی: `PlaceSearchAttributionPosition` پیش‌فرض: `PlaceSearchAttributionPosition.TOP` موقعیت نشان منبع و دکمه شفاف‌سازی قانونی. مشخصه HTML: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	نوع ورودی: `PlaceSearchOrientation optional` نوع خروجی: `PlaceSearchOrientation` پیش‌فرض: `PlaceSearchOrientation.VERTICAL` گونه جهت (عمودی یا افقی) عنصر. مشخصه HTML: `orientation="value-name"`
`selectable` attr: selectable	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` آیا موارد فهرست قابل‌انتخاب هستند یا نه. اگر درست باشد، موارد فهرست دکمه‌هایی خواهند بود که هنگام کلیک شدن، رویداد `gmp-select` را ارسال می‌کنند. پیمایش و انتخاب با صفحه‌کلید دسترس‌پذیر نیز پشتیبانی می‌شود. مشخصه HTML: `selectable`
`truncationPreferred` attr: truncation-preferred	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` اگر درست باشد، خطوط خاصی از محتوا را کوتاه می‌کند تا به‌جای پیچیدن در یک خط جا شود. مشخصه HTML: `truncation-preferred`
از سازمان بالاتر: `places`

ماشین سکه‌ای
`details-item`	قالب HTML که حاوی ابزاره‌های gmp-place برای ارائه هر مکان در نتایج جستجو است.

دارایی‌های CSS
`--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`، `removeEventListener`

رویدادها
`gmp-error`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
`gmp-load`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.
`gmp-select`	`function(event)` متغیرهای مستقل: `event: PlaceSelectEvent optional` این رویداد زمانی فعال می‌شود که مکانی از فهرست انتخاب شود. حاوی شیء `Place` است که شامل شناسه، مکان، و نمای دید مکان انتخاب‌شده است.

میانای AdvancedPlaceSearchElementOptions

میانای google.maps.places.AdvancedPlaceSearchElementOptions PlaceSearchElementOptions را گسترش می‌دهد
توسط AdvancedPlaceSearchElement پیاده‌سازی شده است

گزینه‌های AdvancedPlaceSearchElement.

مشخصات
`attributionPosition` اختیاری	نوع: `PlaceSearchAttributionPosition optional` `PlaceSearchElement.attributionPosition` را ببینید.
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.
`orientation` اختیاری	نوع: `PlaceSearchOrientation optional` `PlaceSearchElement.orientation` را ببینید.
`selectable` اختیاری	نوع: `boolean optional` مشاهده `PlaceSearchElement.selectable`
`truncationPreferred` اختیاری	نوع: `boolean optional` `PlaceSearchElement.truncationPreferred` را ببینید.

AdvancedPlaceListElement کلاس

class google.maps.places.AdvancedPlaceListElement extends HTMLElement implements AdvancedPlaceListElementOptions
library "places"

نتایج جستجوی مکان را در فهرست نمایش می‌دهد. یک یا چند PlaceDetailsPlaceRequestElement اضافه کنید یا خصوصیت places را برای مشخص کردن مکان‌های نمایش تنظیم کنید. برای مشخص کردن محتوایی که باید ارائه شود، PlaceStandardContentElement یا PlaceAllContentElement را اضافه کنید.

مثال:

 <gmp-advanced-place-list>
   <gmp-place-details-place-request
     place="PLACE_ID"
   </gmp-place-details-place-request>
   <template slot="details-item">
     <gmp-place-media lightbox-preferred></gmp-place-media>
   </template>
 </gmp-advanced-place-list>

برای استفاده از «عنصر فهرست مکان پیشرفته»، میانای برنامه‌سازی کاربردی کیت میانای کاربر «جاها» را برای پروژه‌تان در کنسول Google Cloud فعال کنید.

<gmp-advanced-place-list
  attribution-position="value-name"
  internal-usage-attribution-ids="space separated strings"
  orientation="value-name"
  places="space separated strings"
  selectable
  truncation-preferred>
</gmp-advanced-place-list>

const {AdvancedPlaceListElement} = await google.maps.importLibrary("places");

سازنده
`AdvancedPlaceListElement`	`AdvancedPlaceListElement([options])` پارامترها: `options: AdvancedPlaceListElementOptions optional`

مشخصات
`attributionPosition` attr: attribution-position	نوع ورودی: `PlaceSearchAttributionPosition optional` نوع خروجی: `PlaceSearchAttributionPosition` پیش‌فرض: `PlaceSearchAttributionPosition.TOP` موقعیت نشان منبع و دکمه شفاف‌سازی قانونی. مشخصه HTML: `attribution-position="value-name"`
`internalUsageAttributionIds` attr: internal-usage-attribution-ids	نوع ورودی: `Iterable<string> optional` نوع خروجی: `Array<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود. مشخصه HTML: `internal-usage-attribution-ids="space separated strings"`
`orientation` attr: orientation	نوع ورودی: `PlaceSearchOrientation optional` نوع خروجی: `PlaceSearchOrientation` پیش‌فرض: `PlaceSearchOrientation.VERTICAL` گونه جهت (عمودی یا افقی) عنصر. مشخصه HTML: `orientation="value-name"`
`places` مشخصه: مکان‌ها	نوع ورودی: `Iterable<Place\|string> optional` نوع خروجی: `Array<Place>` فهرست اشیای «مکان» حاوی شناسه‌هایی که باید در این عنصر نمایش داده شود. توجه داشته باشید که اگر همه «مکان‌های» تنظیم‌شده در ویژگی مکان‌ها قابل‌پرداخت نباشند(مثلاً شناسه نامعتبر، خطای درخواست شبکه، و غیره)، ممکن است نمایش داده نشوند. ویژگی مکان‌ها را می‌توان برای بازیابی مکان‌های نمایش‌داده‌شده فعلی خواند. مشخصه HTML: `places="space separated strings"`
`selectable` attr: selectable	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` آیا موارد فهرست قابل‌انتخاب هستند یا نه. اگر درست باشد، موارد فهرست دکمه‌هایی خواهند بود که هنگام کلیک شدن، رویداد `gmp-select` را ارسال می‌کنند. پیمایش و انتخاب با صفحه‌کلید دسترس‌پذیر نیز پشتیبانی می‌شود. مشخصه HTML: `selectable`
`truncationPreferred` attr: truncation-preferred	نوع ورودی: `boolean optional` نوع خروجی: `boolean` پیش‌فرض: `false` اگر درست باشد، خطوط خاصی از محتوا را کوتاه می‌کند تا به‌جای پیچیدن در یک خط جا شود. مشخصه HTML: `truncation-preferred`

ماشین سکه‌ای
`details-item`	قالب HTML که حاوی ابزاره‌های gmp-place برای ارائه هر مکان در فهرست است.

دارایی‌های CSS
`--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`، `removeEventListener`

رویدادها
`gmp-error`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که درخواست به پس‌زمینه رد شده باشد (مثلاً کلید میانای برنامه‌سازی کاربردی نادرست). این رویداد حباب ندارد.
`gmp-load`	`function(event)` متغیرهای مستقل: `event: Event optional` این رویداد زمانی فعال می‌شود که عنصر بار شود و محتوای خود را ارائه دهد. این رویداد حباب ندارد.
`gmp-select`	`function(event)` متغیرهای مستقل: `event: PlaceSelectEvent optional` این رویداد زمانی فعال می‌شود که مکانی از فهرست انتخاب شود. حاوی شیء `Place` است که شامل شناسه، مکان، و نمای دید مکان انتخاب‌شده است.

میانای AdvancedPlaceListElementOptions

میانا google.maps.places.AdvancedPlaceListElementOptions
پیاده‌سازی‌شده توسط AdvancedPlaceListElement

گزینه‌های AdvancedPlaceListElement.

مشخصات
`attributionPosition` اختیاری	نوع: `PlaceSearchAttributionPosition optional` `PlaceSearchElement.attributionPosition` را ببینید.
`internalUsageAttributionIds` اختیاری	نوع: `Iterable<string> optional` شناسه‌هایی که برای نسبت دادن تماس‌ها به بسته‌های خاص یا کتابخانه‌های OSS استفاده می‌شود.
`orientation` اختیاری	نوع: `PlaceSearchOrientation optional` `PlaceSearchElement.orientation` را ببینید.
`places` اختیاری	نوع: `Iterable<Place\|string> optional` `AdvancedPlaceListElement.places` را ببینید.
`selectable` اختیاری	نوع: `boolean optional` مشاهده `PlaceSearchElement.selectable`
`truncationPreferred` اختیاری	نوع: `boolean optional` `PlaceSearchElement.truncationPreferred` را ببینید.

کلاس AdvancedPlaceItemElement

class google.maps.places.AdvancedPlaceItemElement extends PlaceItemElement, HTMLElement implements AdvancedPlaceItemElementOptions, PlaceItemElementOptions
library "places"

پوشاننده مؤلفه وب عمومی (<gmp-advanced-place-item>) برای موارد فهرست مکان پیشرفته. عنصر سفارشی <gmp-advanced-place-item> یک کارت نتیجه غنی مکان را به‌صورت تکی در یک محفظه جستجوی پیشرفته یا مجموعه، مانند <gmp-advanced-place-search> یا <gmp-advanced-place-list>، ارائه می‌دهد. هر <gmp-advanced-place-item> جزئیات غنی مکان، کلاژهای رسانه‌ای، خلاصه‌های سرمقاله‌ای، و دکمه‌های کنش تعاملی متشکل از مؤلفه‌های دیداری فرزند از «کیت میانای کاربر جاها» را ارائه می‌دهد.

<gmp-advanced-place-item></gmp-advanced-place-item>

const {AdvancedPlaceItemElement} = await google.maps.importLibrary("places");

ماشین سکه‌ای
`basic-section-bottom`	توجه: فقط در کانال v=alpha دردسترس است. جایگاهی برای محتوای HTML سفارشی که در پایین بخش اطلاعات پایه، درست زیر دکمه‌های کنش اصلی، ارائه می‌شود.
`basic-section-top`	توجه: فقط در کانال v=alpha دردسترس است. جایگاهی برای محتوای HTML سفارشی که در بخش اطلاعات پایه، مستقیماً بالای نام مکان، ارائه می‌شود.

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای AdvancedPlaceItemElementOptions

میانای google.maps.places.AdvancedPlaceItemElementOptions PlaceItemElementOptions را گسترش می‌دهد
توسط AdvancedPlaceItemElement پیاده‌سازی شده است

گزینه‌های AdvancedPlaceItemElement.

ثابت‌های PlaceSearchAttributionPosition

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

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

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

const {PlaceSearchAttributionPosition} = await google.maps.importLibrary("places");

ثابت‌ها
`BOTTOM`	ارجاع در پایین PlaceSearchElement
`TOP`	اسناددهی در بالای PlaceSearchElement

ثابت‌های PlaceSearchOrientation

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

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

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

const {PlaceSearchOrientation} = await google.maps.importLibrary("places");

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

کلاس PlaceSelectEvent

class google.maps.places.PlaceSelectEvent extends Event
library "places"

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

const {PlaceSelectEvent} = await google.maps.importLibrary("places");

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

PlaceNearbySearchRequestElement class

class google.maps.places.PlaceNearbySearchRequestElement extends HTMLElement implements PlaceNearbySearchRequestElementOptions
library "places"

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="value-name">
</gmp-place-nearby-search-request>

const {PlaceNearbySearchRequestElement} = await google.maps.importLibrary("places");

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

مشخصات
`excludedPrimaryTypes` attr: excluded-primary-types	نوع ورودی: `Array<string> optional` نوع خروجی: `Array<string> optional` پیش‌فرض: `null` انواع مکان اصلی مستثناشده. مشخصه HTML: `excluded-primary-types="excluded-primary-type1 excluded-primary-type2..."`
`excludedTypes` attr: excluded-types	نوع ورودی: `Array<string> optional` نوع خروجی: `Array<string> optional` پیش‌فرض: `null` انواع مکان مستثنی‌شده. مشخصه HTML: `excluded-types="excluded-type1 excluded-type2..."`
`futureOpeningBusinessesIncluded`	نوع ورودی: `boolean optional` نوع خروجی: `boolean optional` پیش‌بینی‌های مکان را برای کسب‌وکارهایی که هنوز باز نشده‌اند اما انتظار می‌رود در آینده باز شوند اضافه کنید.
`includedPrimaryTypes` attr: included-primary-types	نوع ورودی: `Array<string> optional` نوع خروجی: `Array<string> optional` پیش‌فرض: `null` نوع مکان اصلی گنجانده‌شده. مشخصه HTML: `included-primary-types="included-primary-type1 included-primary-type2..."`
`includedTypes` attr: included-types	نوع ورودی: `Array<string> optional` نوع خروجی: `Array<string> optional` پیش‌فرض: `null` نوع مکان دربرگرفته‌شده. مشخصه HTML: `included-types="included-type1 included-type2..."`
`locationRestriction` attr: location-restriction	نوع ورودی: `Circle\|CircleLiteral optional` نوع خروجی: `Circle optional` پیش‌فرض: `null` منطقه موردنظر برای جستجو. به `Circle` نرمال‌سازی می‌شود. مشخصه HTML: `location-restriction="radius@lat,lng"`
`maxResultCount` attr: max-result-count	نوع ورودی: `number optional` نوع خروجی: `number optional` پیش‌فرض: `null` حداکثر تعداد نتایج برای برگرداندن. مشخصه HTML: `max-result-count="number"`
`rankPreference` attr: rank-preference	نوع ورودی: `SearchNearbyRankPreference optional` نوع خروجی: `SearchNearbyRankPreference optional` پیش‌فرض: `null` نحوه رتبه‌بندی نتایج در پاسخ. مشخصه HTML: `rank-preference="value-name"`

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceNearbySearchRequestElementOptions

میانا google.maps.places.PlaceNearbySearchRequestElementOptions
پیاده‌سازی‌شده توسط PlaceNearbySearchRequestElement

گزینه‌های PlaceNearbySearchRequestElement.

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

کلاس PlaceTextSearchRequestElement

class google.maps.places.PlaceTextSearchRequestElement extends HTMLElement implements PlaceTextSearchRequestElementOptions
library "places"

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="number"
  included-type="type"
  is-open-now
  location-bias="lat,lng"
  location-restriction="southwest-lat,southwest-lng|northeast-lat,northeast-lng"
  max-result-count="number"
  min-rating="number"
  price-levels="price-level1 price-level2..."
  rank-preference="value-name"
  text-query="string"
  use-strict-type-filtering>
</gmp-place-text-search-request>

const {PlaceTextSearchRequestElement} = await google.maps.importLibrary("places");

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

مشخصات
`evConnectorTypes` attr: ev-connector-types	نوع ورودی: `Array<EVConnectorType> optional` نوع خروجی: `Array<EVConnectorType> optional` پیش‌فرض: `null` فهرست انواع رابط‌های خودرو برقی ترجیحی. مشخصه HTML: `ev-connector-types="ev-connector-type1 ev-connector-type2..."`
`evMinimumChargingRateKw` attr: ev-minimum-charging-rate-kw	نوع ورودی: `number optional` نوع خروجی: `number optional` پیش‌فرض: `null` حداقل نرخ شارژ موردنیاز به کیلووات. مشخصه HTML: `ev-minimum-charging-rate-kw="number"`
`futureOpeningBusinessesIncluded`	نوع ورودی: `boolean optional` نوع خروجی: `boolean optional` پیش‌بینی‌های مکان را برای کسب‌وکارهایی که هنوز باز نشده‌اند اما انتظار می‌رود در آینده باز شوند اضافه کنید.
`includedType` attr: included-type	نوع ورودی: `string optional` نوع خروجی: `string optional` پیش‌فرض: `null` نوع مکان درخواست‌شده. مشخصه HTML: `included-type="type"`
`isOpenNow` attr: is-open-now	نوع ورودی: `boolean optional` نوع خروجی: `boolean optional` پیش‌فرض: `null` برای محدود کردن جستجو به مکان‌هایی که درحال‌حاضر باز هستند استفاده می‌شود. مشخصه HTML: `is-open-now`
`locationBias` attr: location-bias	نوع ورودی: `LocationBias optional` نوع خروجی: `LatLngAltitude\|LatLngBounds\|Circle\|string optional` پیش‌فرض: `null` سوگیری مکان برای جستجو. مشخصه HTML: `location-bias="lat,lng"` `location-bias="lat,lng[,altitude]"` `location-bias="swlat,swlng\|nelat,nelng"` `location-bias="radius@lat,lng"` `location-bias="IP_BIAS"`
`locationRestriction` attr: location-restriction	نوع ورودی: `LatLngBounds\|LatLngBoundsLiteral optional` نوع خروجی: `LatLngBounds optional` پیش‌فرض: `null` محدودیت مکان برای جستجو. به `LatLngBounds` نرمال‌سازی می‌شود. مشخصه HTML: `location-restriction="southwest-lat,southwest-lng\|northeast-lat,northeast-lng"`
`maxResultCount` attr: max-result-count	نوع ورودی: `number optional` نوع خروجی: `number optional` پیش‌فرض: `null` حداکثر تعداد نتایج برای برگرداندن. مشخصه HTML: `max-result-count="number"`
`minRating` attr: min-rating	نوع ورودی: `number optional` نوع خروجی: `number optional` پیش‌فرض: `null` نتایجی را که میانگین رده‌بندی کاربر آن‌ها دقیقاً کمتر از این حد است فیلتر کنید. مشخصه HTML: `min-rating="number"`
`priceLevels` attr: price-levels	نوع ورودی: `Array<PriceLevel> optional` نوع خروجی: `Array<PriceLevel> optional` پیش‌فرض: `null` برای محدود کردن جستجو به مکان‌هایی که با سطوح قیمت خاصی علامت‌گذاری شده‌اند استفاده می‌شود. مشخصه HTML: `price-levels="price-level1 price-level2..."`
`rankPreference` attr: rank-preference	نوع ورودی: `SearchByTextRankPreference optional` نوع خروجی: `SearchByTextRankPreference optional` پیش‌فرض: `null` نحوه رتبه‌بندی نتایج در پاسخ. مشخصه HTML: `rank-preference="value-name"`
`textQuery` attr: text-query	نوع ورودی: `string optional` نوع خروجی: `string optional` پیش‌فرض: `null` پُرسمان نوشتاری برای جستجوی نوشتاری. مشخصه HTML: `text-query="string"`
`useStrictTypeFiltering` attr: use-strict-type-filtering	نوع ورودی: `boolean optional` نوع خروجی: `boolean optional` پیش‌فرض: `null` برای تنظیم فیلتر نوع دقیق برای «includedType» استفاده می‌شود. مشخصه HTML: `use-strict-type-filtering`

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceTextSearchRequestElementOptions

میانا google.maps.places.PlaceTextSearchRequestElementOptions
پیاده‌سازی‌شده توسط PlaceTextSearchRequestElement

گزینه‌های PlaceTextSearchRequestElement.

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

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

class google.maps.places.Autocomplete extends MVCObject
library "places"

منسوخ‌شده: از ۱ مارس ۲۰۲۵، google.maps.places.Autocomplete برای مشتریان جدید دردسترس نیست. لطفاً به‌جای آن از PlaceAutocompleteElement استفاده کنید. درحال‌حاضر، برنامه‌ای برای توقف google.maps.places.Autocomplete وجود ندارد، اما PlaceAutocompleteElement نسبت‌به google.maps.places.Autocomplete توصیه می‌شود. درحالی‌که google.maps.places.Autocomplete همچنان برای هرگونه پس‌رفت عمده رفع اشکال دریافت خواهد کرد، اشکالات موجود در google.maps.places.Autocomplete برطرف نخواهد شد. حداقل ۱۲ ماه قبل‌از توقف پشتیبانی، اعلان ارائه خواهد شد. لطفاً برای جزئیات بیشتر، https://developers.google.com/maps/legacy را ببینید و برای راهنمای انتقال، https://developers.google.com/maps/documentation/javascript/places-migration-overview را ببینید.

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

const {Autocomplete} = await google.maps.importLibrary("places");

سازنده

Autocomplete

Autocomplete(inputField[, opts])

پارامترها:

inputField: HTMLInputElement فیلد نوشتار <input> که Autocomplete باید به آن پیوست شود.
گزینه‌های opts: AutocompleteOptions optional.

نمونه جدیدی از Autocomplete ایجاد می‌کند که با گزینه‌های ارائه‌شده به فیلد نوشتار ورودی مشخص‌شده پیوست می‌شود.

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

رویدادها

place_changed

function()

متغیرهای مستقل: هیچ

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

میانای AutocompleteOptions

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

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

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

class google.maps.places.SearchBox extends MVCObject
library "places"

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

const {SearchBox} = await google.maps.importLibrary("places");

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

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

رویدادها
`places_changed`	`function()` متغیرهای مستقل: هیچ این رویداد زمانی فعال می‌شود که کاربر پُرسمانی را انتخاب کند، `getPlaces` باید برای دریافت مکان‌های جدید استفاده شود.

میانای SearchBoxOptions

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

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

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

PlaceContextualElement کلاس

class google.maps.places.PlaceContextualElement extends HTMLElement implements PlaceContextualElementOptions
library "places"

ابزاره‌ای که از داده‌واحد بافتی برای نمایش نمای بافتاری پاسخ «پایه‌مندسازی با Google Maps» استفاده می‌کند.

<gmp-place-contextual
  context-token="string">
</gmp-place-contextual>

const {PlaceContextualElement} = await google.maps.importLibrary("places");

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

مشخصات
`contextToken` attr: context-token	نوع ورودی: `string optional` نوع خروجی: `string optional` داده‌واحد بافتی. مشخصه HTML: `context-token="string"`

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceContextualElementOptions

میانا google.maps.places.PlaceContextualElementOptions
پیاده‌سازی‌شده توسط PlaceContextualElement

گزینه‌های PlaceContextualElement.

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

PlaceContextualListConfigElement کلاس

class google.maps.places.PlaceContextualListConfigElement extends HTMLElement implements PlaceContextualListConfigElementOptions
library "places"

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

<gmp-place-contextual-list-config
  layout="value-name"
  map-hidden>
</gmp-place-contextual-list-config>

const {PlaceContextualListConfigElement} = await google.maps.importLibrary("places");

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

مشخصات
`layout` attr: layout	نوع ورودی: `PlaceContextualListLayout optional` نوع خروجی: `PlaceContextualListLayout` چیدمان. مشخصه HTML: `layout="value-name"`
`mapHidden` attr: map-hidden	نوع ورودی: `boolean optional` نوع خروجی: `boolean` اینکه نقشه پنهان است یا نه. مشخصه HTML: `map-hidden`

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

میانای PlaceContextualListConfigElementOptions

میانا google.maps.places.PlaceContextualListConfigElementOptions
پیاده‌سازی‌شده توسط PlaceContextualListConfigElement

گزینه‌های PlaceContextualListConfigElement.

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

ثابت‌های PlaceContextualListLayout

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

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

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

const {PlaceContextualListLayout} = await google.maps.importLibrary("places");

ثابت‌ها
`COMPACT`	چیدمان فهرست فشرده: موارد فهرست به‌صورت پیوندهایی در یک خط ارائه می‌شوند و موارد اضافی در فهرست کرکره‌ای قرار می‌گیرند.
`VERTICAL`	چیدمان فهرست عمودی: موارد فهرست به‌صورت کارت در فهرست عمودی ارائه می‌شوند.

PlacePinElement کلاس

class google.maps.places.PlacePinElement extends HTMLElement implements PlacePinElementOptions
library "places"

سنجاق نقشه را برای مکان بااستفاده از نماد دسته یا عکس مکان نمایش می‌دهد. برای مشخص کردن مکان، PlaceDetailsPlaceRequestElement یا PlaceDetailsLocationRequestElement را اضافه کنید. از سنجاق به‌عنوان محتوای AdvancedMarkerElement استفاده کنید. در نقشه‌های سه‌بعدی پشتیبانی نمی‌شود.

مثال:

 <gmp-advanced-marker>
   <gmp-place-pin>
     <gmp-place-details-place-request
       place="PLACE_ID"
     ></gmp-place-details-place-request>
     <gmp-place-rating></gmp-place-rating>
   </gmp-place-pin>
 </gmp-advanced-marker>

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

<gmp-place-pin
  icon="value-name"
  scale="number">
</gmp-place-pin>

const {PlacePinElement} = await google.maps.importLibrary("places");

سازنده
`PlacePinElement`	`PlacePinElement([options])` پارامترها: `options: PlacePinElementOptions optional`

مشخصات
`icon` attr: icon	نوع ورودی: `PlacePinIcon optional` نوع خروجی: `PlacePinIcon` پیش‌فرض: `PlacePinIcon.TYPE` نمادی که داخل سنجاق نشان داده می‌شود. `PlacePinIcon` را ببینید. مشخصه HTML: `icon="value-name"`
`photoRendered` readonly	نوع: `boolean` فقط خواندنی. اگر سنجاق عکس مکان را نشان دهد، درست است. اگر `icon` `PHOTO` نباشد، همیشه نادرست است. اگر `icon` برابر با `PHOTO` باشد اما مکان عکسی نداشته باشد یا عکس بار نشود، این مقدار نادرست است و سنجاق به‌جای آن نماد نوع مکان را نشان می‌دهد. قبل‌از فعال شدن `gmp-load` تنظیم کنید.
`place` readonly	نوع: `Place optional` فقط خواندنی. شیء مکان حاوی شناسه، مکان، و نمای هدف مکان ارائه‌شده فعلی. `undefined` اگر مکان هنوز بار نشده است یا بار نشد.
`scale` attr: scale	نوع ورودی: `number optional` نوع خروجی: `number` پیش‌فرض: `1` ضریب اندازه برای سنجاق. مشخصه HTML: `scale="number"`

ماشین سکه‌ای

default

محتوای اختیاری نشان‌داده‌شده روی سنجاق، مثل PlaceRatingElement، <span> سفارشی، یا نوشتار. فرزندان Light DOM مستقیماً در پین قرار می‌گیرند. محل نمایش محتوا به icon بستگی دارد: کنار نماد نوع مکان برای TYPE، به‌عنوان نشان روی عکس برای PHOTO، و به‌عنوان محتوای اصلی سنجاق برای NONE.

دارایی‌های CSS
`--gmp-background`	رنگ پس‌زمینه سنجاق: کپسول، قاب عکس، نشان عکس، نوک، و حاشیه سنجاق نوع مکان.
`--gmp-border-radius`	شعاع حاشیه کپسول (نماد نوع مکان با محتوای شکاف‌دار، یا فقط محتوای شکاف‌دار) و قاب عکس در سنجاق‌های `PHOTO`. به‌طور پیش‌فرض `30px` برای نماد نوع مکان با محتوای جای‌گذاری‌شده، `12px` برای محتوای جای‌گذاری‌شده به‌تنهایی، و قاب عکس `12px` است. برای سنجاق نوع مکان بدون محتوای شکاف‌دار اعمال نمی‌شود.
`--gmp-glyph-background`	رنگ پس‌زمینه پشت نماد نوع مکان. به‌طور پیش‌فرض به `iconBackgroundColor` مکان می‌رود.
`--gmp-glyph-color`	رنگ گلیف نوع مکان. هرزمان که نماد نشان داده شود، ازجمله زمانی که سنجاق `PHOTO` به نماد نوع مکان برگردد، اعمال می‌شود.

روش‌ها
به‌ارث‌رسیده: `addEventListener`، `removeEventListener`

رویدادها

gmp-error

function(event)

متغیرهای مستقل:

event: Event optional

این رویداد زمانی فعال می‌شود که سنجاق اصلاً قابل‌ارائه نباشد، مثلاً به‌دلیل خرابی شبکه، خرابی اطلاعات کاربری (مانند کلید API نادرست)، شناسه مکانی که قابل‌حل نباشد، یا مکانی بدون موقعیت. سنجاق پنهان است. این رویداد حباب ندارد.

gmp-load

function(event)

متغیرهای مستقل:

event: Event optional

این رویداد زمانی فعال می‌شود که جزئیات مکان بار شده باشد و سنجاق رندر شده باشد. وقتی icon PHOTO باشد، فقط پس‌از بار شدن یا نشدن عکس فعال می‌شود؛ بار نشدن عکس به‌تنهایی gmp-error را فعال نمی‌کند. مکان بارشده را از PlacePinElement.place بخوانید و ببینید آیا عکس از PlacePinElement.photoRendered نشان داده می‌شود یا نه. این رویداد حباب ندارد.

میانای PlacePinElementOptions

میانا google.maps.places.PlacePinElementOptions
پیاده‌سازی‌شده توسط PlacePinElement

گزینه‌های ساختن PlacePinElement.

مشخصات
`icon` اختیاری	نوع: `PlacePinIcon optional` `PlacePinElement.icon` را ببینید.
`scale` اختیاری	نوع: `number optional` `PlacePinElement.scale` را ببینید.

PlacePinIcon ثابت‌ها

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

گزینه‌های نماد برای PlacePinElement. TYPE پیش‌فرض است. اگر داده‌های موردنیاز برای نماد انتخاب‌شده وجود نداشته باشد، سنجاق به TYPE برمی‌گردد. اگر داده‌های موردنیاز برای TYPE وجود نداشته باشد، نمادی عمومی به‌جای آن نشان داده می‌شود.

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

const {PlacePinIcon} = await google.maps.importLibrary("places");

ثابت‌ها
`NONE`	هیچ نمادی نشان نمی‌دهد، فقط محتوای شکاف‌دار را نشان می‌دهد.
`PHOTO`	عکس مکان را در دایره نشان می‌دهد. اگر مکان عکس نداشته باشد، به `TYPE` برمی‌گردد.
`TYPE`	نماد دسته مکان را نشان می‌دهد.

Places Widgets با مجموعه‌ها، منظم بمانید ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.

PlaceAutocompleteElement class

سازنده

مشخصات

ماشین سکه‌ای

قطعات

دارایی‌های CSS

روش‌ها

رویدادها

میانای PlaceAutocompleteElementOptions

مشخصات

کلاس PlacePredictionSelectEvent

مشخصات

کلاس BasicPlaceAutocompleteElement

سازنده

مشخصات

ماشین سکه‌ای

قطعات

دارایی‌های CSS

روش‌ها

رویدادها

میانای BasicPlaceAutocompleteElementOptions

مشخصات

کلاس PlaceDetailsElement

سازنده

مشخصات

دارایی‌های CSS

روش‌ها

رویدادها

میانای PlaceDetailsElementOptions

مشخصات

کلاس PlaceDetailsCompactElement

سازنده

مشخصات

دارایی‌های CSS

روش‌ها

رویدادها

میانای PlaceDetailsCompactElementOptions

مشخصات

کلاس AdvancedPlaceDetailsElement

سازنده

مشخصات

ماشین سکه‌ای

دارایی‌های CSS

روش‌ها

رویدادها

میانای AdvancedPlaceDetailsElementOptions

مشخصات

کلاس AdvancedPlaceDetailsCompactElement

سازنده

مشخصات

ماشین سکه‌ای

دارایی‌های CSS

روش‌ها

رویدادها

میانای AdvancedPlaceDetailsCompactElementOptions

مشخصات

ثابت‌های PlaceDetailsOrientation

ثابت‌ها

کلاس PlaceDetailsPlaceRequestElement

سازنده

مشخصات

روش‌ها

میانای PlaceDetailsPlaceRequestElementOptions

مشخصات

کلاس PlaceDetailsLocationRequestElement

سازنده

مشخصات

روش‌ها

میانای PlaceDetailsLocationRequestElementOptions

مشخصات

PlaceSearchElement کلاس

سازنده

مشخصات

دارایی‌های CSS

روش‌ها

رویدادها

میانای PlaceSearchElementOptions

مشخصات

PlaceItemElement کلاس

Places Widgets