کلاس PlaceAutocompleteElement
google.maps.places . PlaceAutocompleteElement
کلاس google.maps.places . PlaceAutocompleteElement
- PlaceAutocompleteElement یک زیر کلاس
HTMLElement
است که یک مؤلفه UI برای Places Autocomplete API فراهم می کند. پس از بارگیری کتابخانهplaces
، می توان یک ورودی با قابلیت تکمیل خودکار در HTML ایجاد کرد. به عنوان مثال:<gmp-placeautocomplete ></gmp-placeautocomplete>
عنصر سفارشی:
<gmp-placeautocomplete></gmp-placeautocomplete>
این کلاس HTMLElement
گسترش می دهد.
این کلاس PlaceAutocompleteElementOptions
را پیاده سازی می کند.
با فراخوانی const {PlaceAutocompleteElement} = await google.maps.importLibrary("places")
دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.
سازنده | |
---|---|
PlaceAutocompleteElement | PlaceAutocompleteElement(options) مولفه های:
|
خواص | |
---|---|
inputElement | نوع: HTMLInputElement عنصر ورودی برای نشان دادن تکمیل خودکار. |
ارثی: componentRestrictions ، locationBias ، locationRestriction ، requestedLanguage ، requestedRegion ، types |
مواد و روش ها | |
---|---|
addEventListener | addEventListener(type, listener[, options]) مولفه های:
مقدار برگشتی: void تابعی را تنظیم می کند که هر زمان که رویداد مشخص شده به هدف تحویل داده شود فراخوانی می شود. به addEventListener مراجعه کنید |
removeEventListener | removeEventListener(type, listener[, options]) مولفه های:
مقدار برگشتی: void شنونده رویدادی که قبلاً با addEventListener ثبت شده بود را از هدف حذف می کند. removeEventListener را ببینید |
رابط PlaceAutocompleteElementOptions
google.maps.places . PlaceAutocompleteElementOptions
رابط google.maps.places . PlaceAutocompleteElementOptions
گزینه هایی برای ساخت PlaceAutocompleteElement.
خواص | |
---|---|
inputElement | نوع: HTMLInputElement عنصر ورودی برای نشان دادن تکمیل خودکار. |
componentRestrictions optional | نوع: ComponentRestrictions optional محدودیت های جزء محدودیتهای مؤلفه برای محدود کردن پیشبینیها فقط به آنهایی که در مؤلفه اصلی هستند استفاده میشوند. مثلا کشور. |
locationBias optional | نوع: LocationBias optional یک مرز نرم یا اشاره برای استفاده در هنگام جستجوی مکانها. |
locationRestriction optional | نوع: LocationRestriction optional محدودیت هایی برای محدود کردن نتایج جستجو. |
requestedLanguage optional | نوع: string optional در صورت امکان، یک شناسه زبان برای زبانی که نتایج باید به آن بازگردانده شود. ممکن است به نتایج زبان انتخابی رتبه بالاتری داده شود، اما پیشنهادات محدود به این زبان نیست. لیست زبان های پشتیبانی شده را ببینید. |
requestedRegion optional | نوع: string optional یک کد منطقه ای که برای قالب بندی نتایج و برای فیلتر کردن نتایج استفاده می شود. این پیشنهادات را به این کشور محدود نمی کند. کد منطقه یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") را می پذیرد. اکثر کدهای ccTLD با کدهای ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. به عنوان مثال، ccTLD بریتانیا "uk" ( .co.uk ) است در حالی که کد ISO 3166-1 آن "gb" است (از لحاظ فنی برای نهاد "پادشاهی متحده بریتانیای کبیر و ایرلند شمالی"). |
types optional | نوع: Array <string> optional انواع پیش بینی هایی که باید برگردانده شوند. برای انواع پشتیبانی شده، به راهنمای برنامه نویس مراجعه کنید. اگر هیچ نوع مشخص نشده باشد، همه انواع برگردانده می شوند. |
کلاس PlaceAutocompletePlaceSelectEvent
google.maps.places . PlaceAutocompletePlaceSelectEvent
کلاس google.maps.places . PlaceAutocompletePlaceSelectEvent
این رویداد پس از انتخاب مکان توسط کاربر با عنصر تکمیل خودکار مکان ایجاد می شود. با event.place
به انتخاب دسترسی پیدا کنید.
این کلاس Event
گسترش می دهد.
با فراخوانی const {PlaceAutocompletePlaceSelectEvent} = await google.maps.importLibrary("places")
دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.
کلاس PlaceAutocompleteRequestErrorEvent
google.maps.places . PlaceAutocompleteRequestErrorEvent
کلاس google.maps.places . PlaceAutocompleteRequestErrorEvent
این رویداد توسط PlaceAutocompleteElement زمانی که مشکلی در درخواست شبکه وجود دارد منتشر می شود.
این کلاس Event
گسترش می دهد.
با فراخوانی const {PlaceAutocompleteRequestErrorEvent} = await google.maps.importLibrary("places")
دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.
کلاس تکمیل خودکار
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) مولفه های:
ارزش بازگشتی: ندارد وقتی جزئیات با موفقیت بازیابی شدند، فیلدهایی را تنظیم می کند که برای مکان در پاسخ جزئیات اضافه شوند. برای فهرستی از فیلدها PlaceResult ببینید. |
setOptions | setOptions(options) مولفه های:
ارزش بازگشتی: ندارد |
setTypes | setTypes(types) مولفه های:
ارزش بازگشتی: ندارد انواع پیش بینی هایی را که باید برگردانده شوند را تنظیم می کند. برای انواع پشتیبانی شده، به راهنمای برنامه نویس مراجعه کنید. اگر هیچ نوع مشخص نشده باشد، همه انواع برگردانده می شوند. |
به ارث رسیده: 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'] است. |
| نوع: boolean optional اینکه آیا فقط شناسههای مکان بازیابی شود. PlaceResult که با فعال شدن رویداد place_changed در دسترس قرار میگیرد، فقط دارای فیلدهای place_id، انواع و نام است و مکان_id، انواع و توضیحات توسط سرویس تکمیل خودکار بازگردانده میشود. به طور پیش فرض غیرفعال است. |
strictBounds optional | نوع: boolean optional یک مقدار بولی که نشان میدهد ویجت تکمیل خودکار فقط باید آن مکانهایی را برگرداند که در زمان ارسال پرس و جو در داخل محدوده ویجت تکمیل خودکار قرار دارند. تنظیم strictBounds روی false (که پیشفرض است) باعث میشود نتایج به سمت مکانهای موجود در محدودهها، اما نه محدود به آن، سوگیری شوند. |
types optional | نوع: Array <string> optional انواع پیش بینی هایی که باید برگردانده شوند. برای انواع پشتیبانی شده، به راهنمای برنامه نویس مراجعه کنید. اگر هیچ نوع مشخص نشده باشد، همه انواع برگردانده می شوند. |
کلاس SearchBox
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 منطقه ای که پیش بینی های پرس و جو به سمت آن سوگیری می شود. پیشبینیها به سمت پرسشهایی که این محدودهها را هدف قرار میدهند، تعصب دارند، اما محدود به آن نیستند. |