Autocomplete Data (new)

فئة AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion صف

نتيجة اقتراح للإكمال التلقائي

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AutocompleteSuggestion} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.

الطُرق الثابتة

fetchAutocompleteSuggestions

fetchAutocompleteSuggestions(autocompleteRequest) المَعلمات:  autocompleteRequest:  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 interface

واجهة الطلب الخاصة بـ AutocompleteSuggestion.fetchAutocompleteSuggestions

الخصائص
input	النوع:  string سلسلة النص المطلوب البحث عنها.
includedPrimaryTypes optional	النوع:  Array<string> optional تضمين نوع المكان الأساسي (على سبيل المثال، "restaurant" أو "gas_station") لا يتم عرض "مكان" إلا إذا كان نوعه الأساسي مضمّنًا في هذه القائمة. يمكن تحديد ما يصل إلى 5 قيم. في حال عدم تحديد أي أنواع، سيتم عرض جميع أنواع "الأماكن".
includedRegionCodes optional	النوع:  Array<string> optional تضمين النتائج في المناطق المحدّدة فقط، والتي يتم تحديدها على أنّها ما يصل إلى 15 رمزًا من رموز CLDR المكوّنة من حرفَين لن تؤدي المجموعة الفارغة إلى حصر النتائج. إذا تم ضبط كل من locationRestriction وincludedRegionCodes، ستظهر النتائج في منطقة التقاطع.
inputOffset optional	النوع:  number optional إزاحة حرف Unicode مستندة إلى الصفر 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 على أحد AutocompleteSuggestions الناتجة. ننصحك باتّباع الإرشادات التالية: استخدِم رموز الجلسات لجميع طلبات Place Autocomplete. إنشاء رمز مميّز جديد لكل جلسة احرص على تمرير رمز مميّز فريد للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميز نفسه لأكثر من جلسة واحدة إلى تحصيل رسوم من كل طلب على حدة.

فئة AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken صف

تمثّل هذه السمة رمزًا مميزًا للجلسة يُستخدَم لتتبُّع جلسة الإكمال التلقائي.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {AutocompleteSessionToken} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
AutocompleteSessionToken	AutocompleteSessionToken() المَعلمات:  بدون تنشئ هذه الطريقة مثيلاً جديدًا من AutocompleteSessionToken.

فئة 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 المعرّف الفريد للمكان المقترَح. يمكن استخدام هذا المعرّف في واجهات برمجة التطبيقات الأخرى التي تقبل معرّفات الأماكن.
secondaryText	النوع:  FormattableText optional تمثّل هذه السمة ميزات إضافية لإزالة الغموض (مثل مدينة أو منطقة) من أجل تحديد المكان بشكلٍ أكبر.
text	النوع:  FormattableText تحتوي على الاسم الذي يمكن للمستخدم قراءته للنتيجة التي تم إرجاعها. بالنسبة إلى نتائج المؤسسات، يكون ذلك عادةً اسم النشاط التجاري وعنوانه. يُنصح باستخدام text للمطوّرين الذين يريدون عرض عنصر واحد من عناصر واجهة المستخدم. قد يفضّل المطوّرون الذين يريدون عرض عنصرَين منفصلَين ولكن مرتبطَين في واجهة المستخدِم استخدام PlacePrediction.mainText وPlacePrediction.secondaryText بدلاً من ذلك.
types	النوع:  Array<string> قائمة بالأنواع التي تنطبق على هذا المكان من الجدول (أ) أو الجدول (ب) في https://developers.google.com/maps/documentation/places/web-service/place-types

الطُرق
fetchAddressValidation	ملاحظة: تتوفّر هذه الميزة في قناة الإصدار التجريبي v=beta فقط. fetchAddressValidation(request) المَعلمات:  request:  AddressValidationRequest القيمة المعروضة:  لا شيء يرسل هذا الحقل طلب التحقّق من صحة العنوان المرتبط بجلسة الإكمال التلقائي هذه (يتم ملء الطلب داخليًا برمز مميّز لجلسة الإكمال التلقائي). لا يتم تضمين أي معلومات عن المكان من PlacePrediction تلقائيًا، فهذه طريقة ملائمة للمساعدة في إدارة جلسات الإكمال التلقائي.
toPlace	toPlace() المَعلمات:  بدون قيمة العائد:  Place تعرض هذه الطريقة تمثيلاً Place لـ PlacePrediction. يجب إجراء مكالمة لاحقة إلى Place.fetchFields للحصول على تفاصيل كاملة عن المكان. إذا تم توفير AutocompleteRequest.sessionToken في AutocompleteRequest المستخدَم لجلب PlacePrediction هذا، سيتم تضمين الرمز المميز نفسه تلقائيًا عند استدعاء fetchFields. بدلاً من ذلك، عند استخدام PlaceAutocompleteElement، ستتضمّن المكالمة الأولى إلى Place.fetchFields على Place التي تعرضها PlacePrediction.toPlace رمز الجلسة المميز تلقائيًا.

فئة StringRange

google.maps.places.StringRange صف

تحدّد هذه الدالة سلسلة فرعية ضمن نص معيّن.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {StringRange} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.

الخصائص
endOffset	النوع:  number إزاحة مستندة إلى الصفر لآخر حرف Unicode في السلسلة الفرعية (غير شاملة).
startOffset	النوع:  number إزاحة مستندة إلى الصفر لأول حرف Unicode في السلسلة الفرعية (شاملة).

فئة FormattableText

google.maps.places.FormattableText صف

نص يمثّل توقّعًا لمكان يمكن استخدام النص كما هو أو تنسيقه.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {FormattableText} = await google.maps.importLibrary("places").
اطّلِع على المكتبات في Maps JavaScript API.

الخصائص
matches	النوع:  Array<StringRange> قائمة بنطاقات السلاسل التي تحدّد موضع تطابق طلب الإدخال في FormattableText.text. يمكن استخدام النطاقات لتنسيق أجزاء معيّنة من text. قد لا تكون السلاسل الفرعية مطابقة تمامًا لـ AutocompleteRequest.input إذا تم تحديد المطابقة من خلال معايير أخرى غير مطابقة السلسلة (على سبيل المثال، تصحيحات إملائية أو ترجمات صوتية). هذه القيم هي إزاحات أحرف Unicode الخاصة بـ FormattableText.text. ويتم ضمان ترتيب النطاقات حسب قيم الإزاحة المتزايدة.
text	النوع:  string نص يمكن استخدامه كما هو أو تنسيقه باستخدام FormattableText.matches