Places Widgets

کلاس PlaceAutocompleteElement

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

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

عنصر سفارشی:
<gmp-place-autocomplete name="string" requested-language="string" requested-region="string" types="type1 type2 type3..."></gmp-place-autocomplete>

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

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

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

PlaceAutocompleteElement
PlaceAutocompleteElement(options)
پارامترها:
componentRestrictions
نوع: ComponentRestrictions optional
محدودیت های مولفه محدودیت‌های مؤلفه برای محدود کردن پیش‌بینی‌ها فقط به آنهایی که در مؤلفه اصلی هستند استفاده می‌شوند. مثلا کشور.
locationBias
نوع: LocationBias optional
یک مرز نرم یا اشاره برای استفاده در هنگام جستجوی مکان‌ها.
locationRestriction
نوع: LocationRestriction optional
محدودیت هایی برای محدود کردن نتایج جستجو.
name
نوع: string optional
نامی که برای عنصر ورودی استفاده می شود. برای جزئیات به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#name مراجعه کنید. رفتاری مشابه با ویژگی name برای ورودی ها دنبال می کند. توجه داشته باشید که این نامی است که هنگام ارسال فرم استفاده می شود. برای جزئیات بیشتر به https://developer.mozilla.org/en-US/docs/Web/HTML/Element/form مراجعه کنید.
ویژگی HTML:
  • <gmp-placeautocomplete name="string"></gmp-placeautocomplete>
requestedLanguage
نوع: string optional
در صورت امکان، یک شناسه زبان برای زبانی که نتایج باید به آن بازگردانده شوند. ممکن است به نتایج زبان انتخابی رتبه بالاتری داده شود، اما پیشنهادات محدود به این زبان نیست. لیست زبان های پشتیبانی شده را ببینید.
ویژگی HTML:
  • <gmp-place-autocomplete requested-language="string"></gmp-place-autocomplete>
requestedRegion
نوع: string optional
یک کد منطقه ای که برای قالب بندی نتایج و برای فیلتر کردن نتایج استفاده می شود. این پیشنهادات را به این کشور محدود نمی کند. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی").
ویژگی HTML:
  • <gmp-place-autocomplete requested-region="string"></gmp-place-autocomplete>
types
نوع: Array <string> optional
انواع پیش بینی هایی که باید برگردانده شوند. برای انواع پشتیبانی شده، به راهنمای برنامه نویس مراجعه کنید. اگر هیچ نوع مشخص نشده باشد، همه انواع برگردانده می شوند.
ویژگی HTML:
  • <gmp-place-autocomplete types="type1 type2 type3..."></gmp-place-autocomplete>
prediction-item
موردی در فهرست کشویی پیش بینی ها که نشان دهنده یک پیش بینی واحد است.
prediction-item-icon
نمادی که در سمت چپ هر مورد در لیست پیش بینی ها نمایش داده می شود.
prediction-item-main-text
بخشی از پیش بینی - آیتم که متن اصلی پیش بینی است. برای مکان‌های جغرافیایی، این شامل نام مکانی، مانند «سیدنی» یا نام و شماره خیابان، مانند «خیابان 10 کینگ» است. به طور پیش‌فرض، پیش‌بینی آیتم-متن-متن سیاه رنگ است. اگر متن اضافی در پیش‌بینی آیتم وجود داشته باشد، خارج از پیش‌بینی-آیتم-متن-اصلی است و سبک خود را از پیش‌بینی-آیتم به ارث می‌برد. به طور پیش فرض خاکستری رنگ است. متن اضافی معمولاً یک آدرس است.
prediction-item-match
بخشی از پیش بینی برگشتی که با ورودی کاربر مطابقت دارد. به طور پیش فرض، این متن مطابق با متن پررنگ برجسته می شود. توجه داشته باشید که متن تطبیق داده شده ممکن است در هر نقطه ای از پیش بینی مورد باشد. لزوماً بخشی از پیش‌بینی-متن-متن-اصلی نیست.
prediction-item-selected
موردی که کاربر از طریق صفحه کلید به آن می رود. توجه: آیتم های انتخاب شده هم تحت تاثیر سبک های این قسمت و هم سبک های قسمت پیش بینی-آیتم قرار می گیرند.
prediction-list
عنصر بصری حاوی لیستی از پیش بینی های ارائه شده توسط سرویس تکمیل خودکار مکان. این لیست به عنوان یک لیست کشویی در زیر PlaceAutocompleteElement ظاهر می شود.
Beta addEventListener
addEventListener(type, listener[, options])
پارامترها:
  • type : string یک رشته حساس به حروف کوچک و بزرگ که نشان دهنده نوع رویداد برای گوش دادن است.
  • listener : EventListener | EventListenerObject شی ای که اعلان دریافت می کند. این باید یک تابع یا یک شی با متد handleEvent باشد
  • options : boolean| AddEventListenerOptions optional گزینه ها را ببینید. رویدادهای سفارشی فقط capture و passive پشتیبانی می کنند.
مقدار برگشتی: void
تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید
Beta removeEventListener
removeEventListener(type, listener[, options])
پارامترها:
  • type : string رشته ای که نوع رویدادی را که برای حذف شنونده رویداد مشخص می کند.
  • listener : EventListener | EventListenerObject شنونده رویداد کنترل کننده رویداد برای حذف از هدف رویداد.
  • options : boolean| EventListenerOptions optional گزینه ها را ببینید
مقدار برگشتی: void
شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید
gmp-placeselect
function(placeAutocompletePlaceSelectEvent)
استدلال ها:
این رویداد زمانی فعال می‌شود که کاربر پیش‌بینی مکان را انتخاب کند. شامل یک شی مکان است.
gmp-requesterror
function(placeAutocompleteRequestErrorEvent)
استدلال ها:
این رویداد زمانی فعال می شود که یک درخواست به backend رد شود (مثلاً کلید API نادرست). این رویداد حباب نمی کند.

رابط PlaceAutocompleteElementOptions

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

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

componentRestrictions optional
نوع: ComponentRestrictions optional
PlaceAutocompleteElement.componentRestrictions ببینید
locationBias optional
نوع: LocationBias optional
PlaceAutocompleteElement.locationBias ببینید
locationRestriction optional
نوع: LocationRestriction optional
PlaceAutocompleteElement.locationRestriction ببینید
requestedLanguage optional
نوع: string optional
PlaceAutocompleteElement.requestedLanguage ببینید
requestedRegion optional
نوع: string optional
PlaceAutocompleteElement.requestedRegion ببینید
types optional
نوع: Array <string> optional
PlaceAutocompleteElement.types ببینید

کلاس PlaceAutocompletePlaceSelectEvent

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

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

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

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

Beta place
نوع: Place

کلاس PlaceAutocompleteRequestErrorEvent

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

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

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

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

کلاس PlaceDetailsElement

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

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

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

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

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

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

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

رابط PlaceDetailsElementOptions

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

گزینه‌های PlaceDetailsElement .

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

ثابت های PlaceDetailsSize

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

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

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

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

کلاس PlaceListElement

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

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

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

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

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

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

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

رابط PlaceListElementOptions

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

گزینه‌های PlaceListElement .

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

کلاس PlaceListPlaceSelectEvent

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

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

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

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

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

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

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

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

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

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

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

رابط AutocompleteOptions

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

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

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

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

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

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

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

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

رابط SearchBoxOptions

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

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

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