Autocomplete Data (new)

AutocompleteSuggestion کلاس

google.maps.places . AutocompleteSuggestion کلاس

یک نتیجه پیشنهاد تکمیل خودکار.

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

fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
پارامترها:
مقدار بازگشتی: Promise <{suggestions: Array < AutocompleteSuggestion >}>
فهرستی از AutocompleteSuggestions را واکشی می کند.

اگر یک AutocompleteRequest.sessionToken در درخواست ارائه شود، آن رمز جلسه به طور خودکار هنگام فراخوانی Place.fetchFields برای اولین بار، در هر Place که توسط PlacePrediction.toPlace بر روی PlacePrediction به دست آمده برگردانده می شود، اضافه می شود.
placePrediction
نوع: PlacePrediction optional
حاوی نام قابل خواندن توسط انسان برای نتیجه برگشتی است. برای نتایج تاسیس، این معمولاً نام و آدرس کسب و کار است.

اگر یک AutocompleteRequest.sessionToken در AutocompleteRequest مورد استفاده برای واکشی این AutocompleteSuggestion ارائه شده باشد، همان نشانه به طور خودکار هنگام فراخوانی Place.fetchFields برای اولین بار در Place که با تماس به PlacePrediction.toPlace برگردانده شده است، اضافه می شود.

رابط AutocompleteRequest

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

درخواست رابط برای AutocompleteSuggestion.fetchAutocompleteSuggestions .

input
نوع: string
رشته متنی که در آن جستجو می شود.
includedPrimaryTypes optional
نوع: Array <string> optional
شامل نوع مکان اصلی (به عنوان مثال، "رستوران" یا "پمپ بنزین").

یک مکان تنها در صورتی برگردانده می شود که نوع اصلی آن در این لیست گنجانده شده باشد. حداکثر 5 مقدار قابل تعیین است. اگر هیچ نوع مشخصی وجود نداشته باشد، همه انواع Place برگردانده می شوند.
includedRegionCodes optional
نوع: Array <string> optional
فقط شامل نتایج در مناطق مشخص شده، مشخص شده به عنوان حداکثر 15 کد منطقه دو نویسه CLDR. مجموعه خالی نتایج را محدود نمی کند. اگر هر دو locationRestriction و includedRegionCodes تنظیم شده باشند، نتایج در ناحیه تقاطع قرار خواهند گرفت.
inputOffset optional
نوع: number optional
یک افست نویسه یونیکد مبتنی بر صفر از input که موقعیت مکان نما را در input نشان می دهد. موقعیت مکان نما ممکن است بر پیش بینی هایی که برگردانده می شوند تأثیر بگذارد. اگر مشخص نشده باشد، طول input را پیش‌فرض می‌کند.
language optional
نوع: string optional
زبانی که در آن نتایج را برگرداند. به‌طور پیش‌فرض به اولویت زبان مرورگر خواهد بود. اگر زبان مورد استفاده در input با language متفاوت باشد یا اگر مکان بازگشتی ترجمه ای از زبان محلی به language نداشته باشد، نتایج ممکن است به زبان های ترکیبی باشد.
locationBias optional
نوع: LocationBias optional
سوگیری به یک مکان مشخص منجر می شود.

حداکثر یکی از locationBias یا locationRestriction باید تنظیم شود. اگر هیچکدام تنظیم نشده باشند، نتایج توسط آدرس IP بایاس می شوند، به این معنی که آدرس IP به یک مکان غیر دقیق نگاشت می شود و به عنوان سیگنال بایاس استفاده می شود.
locationRestriction optional
نوع: LocationRestriction optional
نتایج را به یک مکان مشخص محدود کنید.

حداکثر یکی از locationBias یا locationRestriction باید تنظیم شود. اگر هیچکدام تنظیم نشده باشند، نتایج توسط آدرس IP بایاس می شوند، به این معنی که آدرس IP به یک مکان غیر دقیق نگاشت می شود و به عنوان سیگنال بایاس استفاده می شود.
origin optional
نوع: LatLng | LatLngLiteral optional
نقطه مبدا که از آن برای محاسبه فاصله ژئودزیکی تا مقصد (به عنوان PlacePrediction.distanceMeters برگردانده می شود). اگر این مقدار حذف شود، فاصله ژئودزیکی برگردانده نخواهد شد.
region optional
نوع: string optional
کد منطقه که به عنوان کد منطقه دو کاراکتری CLDR مشخص شده است. این بر قالب‌بندی آدرس، رتبه‌بندی نتایج تأثیر می‌گذارد و ممکن است بر نتایجی که برگردانده می‌شوند تأثیر بگذارد. این نتایج را به منطقه مشخص شده محدود نمی کند.
sessionToken optional
نوع: AutocompleteSessionToken optional
نشانه ای که یک جلسه تکمیل خودکار را برای اهداف صورتحساب شناسایی می کند. یک نشانه جلسه جدید از طریق AutocompleteSessionToken ایجاد کنید.

جلسه زمانی شروع می شود که کاربر شروع به تایپ یک پرس و جو می کند و زمانی که یک مکان را انتخاب می کند و Place.fetchFields را فرا می خواند به پایان می رسد. هر جلسه می تواند چندین پرس و جو داشته باشد و به دنبال آن یک تماس fetchFields وجود دارد. اعتبار استفاده شده برای هر درخواست در یک جلسه باید متعلق به همان پروژه Google Cloud Console باشد. پس از پایان جلسه، رمز دیگر معتبر نیست. برنامه شما باید برای هر جلسه یک توکن جدید تولید کند. اگر پارامتر sessionToken حذف شود، یا اگر از یک نشانه جلسه استفاده مجدد کنید، هزینه جلسه به گونه ای محاسبه می شود که گویی هیچ نشانه جلسه ارائه نشده است (هر درخواست جداگانه صورتحساب می شود).

هنگامی که یک نشانه جلسه در درخواست AutocompleteSuggestion.fetchAutocompleteSuggestions ارائه می شود، همان نشانه به طور خودکار در اولین تماس با fetchFields در Place با فراخوانی PlacePrediction.toPlace در یکی از AutocompleteSuggestion های منتج از آن باز می گردد، قرار می گیرد.

ما دستورالعمل های زیر را توصیه می کنیم:
  • از نشانه‌های جلسه برای همه تماس‌های تکمیل خودکار مکان استفاده کنید.
  • برای هر جلسه یک نشانه جدید ایجاد کنید.
  • مطمئن شوید که برای هر جلسه جدید یک نشانه جلسه منحصر به فرد ارسال می کنید. استفاده از یک نشانه برای بیش از یک جلسه باعث می شود که هر درخواست به صورت جداگانه صورتحساب شود.

کلاس AutocompleteSessionToken

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

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

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

AutocompleteSessionToken
AutocompleteSessionToken()
پارامترها: ندارد
یک نمونه جدید از AutocompleteSessionToken ایجاد می کند.

کلاس PlacePrediction

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

نتایج پیش‌بینی برای پیش‌بینی تکمیل خودکار مکان.

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

distanceMeters
نوع: number optional
طول ژئودزیک بر حسب متر از origin در صورت مشخص شدن origin .
mainText
نوع: FormattableText optional
نشان دهنده نام مکان است.
placeId
نوع: string
شناسه منحصر به فرد مکان پیشنهادی. این شناسه را می توان در سایر APIهایی که شناسه مکان را می پذیرند استفاده کرد.
secondaryText
نوع: FormattableText optional
نمایانگر ویژگی‌های ابهام‌زدایی اضافی (مانند شهر یا منطقه) برای شناسایی بیشتر مکان است.
text
حاوی نام قابل خواندن توسط انسان برای نتیجه برگشتی است. برای نتایج تاسیس، این معمولاً نام و آدرس کسب و کار است.

text برای توسعه دهندگانی که می خواهند یک عنصر رابط کاربری را نشان دهند توصیه می شود. برنامه‌نویسانی که می‌خواهند دو عنصر رابط کاربری مجزا، اما مرتبط را نشان دهند، ممکن است بخواهند به جای آن PlacePrediction.mainText و PlacePrediction.secondaryText استفاده کنند.
types
نوع: Array <string>
فهرست انواعی که برای این مکان از جدول A یا جدول B در https://developers.google.com/maps/documentation/places/web-service/place-types اعمال می شود.
Beta fetchAddressValidation
fetchAddressValidation(request)
پارامترها:
مقدار بازگشتی: Promise < AddressValidation >
یک درخواست اعتبار سنجی آدرس مرتبط با این جلسه تکمیل خودکار را ارسال می کند (در داخل درخواست را با نشانه جلسه تکمیل خودکار پر می کند). هیچ اطلاعات مکانی از PlacePrediction به طور خودکار گنجانده نمی شود - این یک روش راحت برای کمک به مدیریت جلسه تکمیل خودکار است.
toPlace
toPlace()
پارامترها: ندارد
ارزش برگشتی: Place
یک نمایش Place از این PlacePrediction را برمی‌گرداند. برای دریافت جزئیات کامل مکان، تماس بعدی با Place.fetchFields لازم است.

اگر یک AutocompleteRequest.sessionToken در AutocompleteRequest مورد استفاده برای واکشی این PlacePrediction ارائه شده باشد، همان نشانه به طور خودکار هنگام فراخوانی fetchFields گنجانده می شود.

از طرف دیگر، هنگام استفاده از PlaceAutocompleteElement ، اولین تماس با Place.fetchFields در Place که توسط PlacePrediction.toPlace برگردانده شده است، به طور خودکار شامل نشانه جلسه می شود.

کلاس StringRange

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

یک زیر رشته را در یک متن مشخص شناسایی می کند.

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

endOffset
نوع: number
آفست مبتنی بر صفر آخرین کاراکتر یونیکد رشته فرعی (انحصاری).
startOffset
نوع: number
آفست مبتنی بر صفر اولین کاراکتر یونیکد رشته فرعی (شامل).

کلاس FormattableText

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

متنی که یک پیش‌بینی مکان را نشان می‌دهد. متن ممکن است همانطور که هست یا قالب بندی شده استفاده شود.

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

matches
نوع: Array < StringRange >
فهرستی از محدوده های رشته ای که محل مطابقت درخواست ورودی در FormattableText.text مشخص می کند. محدوده ها را می توان برای قالب بندی بخش های خاصی از text استفاده کرد. اگر تطابق با معیارهایی غیر از تطابق رشته (مثلاً تصحیح املا یا نویسه‌گردانی) تعیین شده باشد، رشته‌های فرعی ممکن است دقیقاً مطابق با AutocompleteRequest.input نباشند. این مقادیر، افست کاراکترهای یونیکد FormattableText.text هستند. محدوده ها با افزایش مقادیر افست سفارش داده می شوند.
text
نوع: string
متنی که ممکن است همانطور که هست استفاده شود یا با FormattableText.matches قالب بندی شود.