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 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
BetafetchAddressValidation
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 صف

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

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم 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