Autocomplete Data (new)

واجهة AutocompleteRequest

google.maps.places.AutocompleteRequest واجهة

طلب واجهة AutocompleteSuggestion.fetchAutocompleteSuggestions

الخصائص
input	النوع:  string سلسلة النصوص المطلوب البحث فيها.
includedPrimaryTypes optional	النوع:  Array<string> optional أن تتضمّن نوع المكان الأساسي (مثل "مطعم" أو "محطة_غاز") لا يتم عرض مكان إلا إذا كان نوعه الأساسي مضمّنًا في هذه القائمة. يمكن تحديد ما يصل إلى 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 أو إعادة استخدام رمز تعريف جلسة، يتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز تعريف جلسة (يتم فوترة كل طلب بشكل منفصل). ننصحك باتّباع الإرشادات التالية: استخدِم الرموز المميّزة للجلسة في جميع طلبات ميزة "إكمال الأماكن تلقائيًا". أنشئ رمزًا مميزًا جديدًا لكل جلسة. احرص على تمرير رمز مميّز للجلسة لكل جلسة جديدة. سيؤدي استخدام الرمز المميّز نفسه لأكثر من جلسة واحدة إلى تحصيل رسوم كل طلب على حدة.

فئة AutocompleteSessionToken

google.maps.places.AutocompleteSessionToken class

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

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

الشركة المصنِّعة
AutocompleteSessionToken	AutocompleteSessionToken() المَعلمات:  بدون لإنشاء مثيل جديد من AutocompleteSessionToken

فئة AutocompleteSuggestion

google.maps.places.AutocompleteSuggestion class

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

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

الطرق الثابتة
fetchAutocompleteSuggestions	fetchAutocompleteSuggestions(autocompleteRequest) المَعلمات:  autocompleteRequest:  AutocompleteRequest القيمة المعروضة:  Promise<{suggestions:Array<AutocompleteSuggestion>}> تُستخدَم هذه الدالة لجلب قائمة باقتراحات الإكمال التلقائي.

الخصائص
placePrediction	النوع:  PlacePrediction optional يحتوي على الاسم السهل القراءة للنتيجة المعروضة. بالنسبة إلى نتائج المؤسسات، يكون هذا عادةً اسم النشاط التجاري وعنوانه.

فئة PlacePrediction

google.maps.places.PlacePrediction class

نتائج التوقّعات لعبارة بحث مقترَحة في ميزة "الإكمال التلقائي" للأماكن

يمكنك الوصول إليه من خلال الاتصال بالرقم const {PlacePrediction} = await google.maps.importLibrary("places"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الخصائص
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

الطُرق
toPlace	toPlace() المَعلمات:  بدون القيمة المعروضة:  Place تعرِض هذه السمة تمثيلاً لمكان "توقّعات الأماكن" هذا. يلزم إجراء مكالمة لاحقة إلى Place.fetchFields للحصول على تفاصيل المكان الكاملة.

فئة StringRange

google.maps.places.StringRange class

لتحديد سلسلة فرعية داخل نص معيّن

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

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

فئة FormattableText

google.maps.places.FormattableText class

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

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

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