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)

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

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

AutocompleteSuggestion

صف واحد (google.maps.places.AutocompleteSuggestion)

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {AutocompleteSuggestion} = await google.maps.importLibrary("places"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
fetchAutocompleteSuggestions
fetchAutocompleteSuggestions(autocompleteRequest)
المَعلمات: 
القيمة المعروضة:  Promise<{suggestions:Array<AutocompleteSuggestion>}>
لجلب قائمة باقتراحات الإكمال التلقائي
placePrediction
النوع:  PlacePrediction optional
يحتوي على اسم يمكن لشخص عادي قراءته للنتيجة المعروضة. في ما يتعلّق بنتائج المؤسسات، يكون عادةً اسم النشاط التجاري وعنوانه.

PlacePrediction المستوى

صف واحد (google.maps.places.PlacePrediction)

نتائج التوقّعات لتوقّعات الإكمال التلقائي لمكان

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

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {StringRange} = await google.maps.importLibrary("places"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
endOffset
النوع:  number
إزاحة قائمة على الصفر لآخر حرف يونيكود في السلسلة الفرعية (حصريًا).
startOffset
النوع:  number
إزاحة قائمة على الصفر لأول حرف يونيكود من السلسلة الفرعية (شاملة).

FormattableText

صف واحد (google.maps.places.FormattableText)

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

بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {FormattableText} = await google.maps.importLibrary("places"). اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
matches
النوع:  Array<StringRange>
قائمة بنطاقات السلاسل التي تحدد مكان مطابقة طلب الإدخال في FormattableText.text. يمكن استخدام النطاقات لتنسيق أجزاء معيّنة من text. وقد لا تكون السلاسل الفرعية متطابقة تمامًا مع AutocompleteRequest.input إذا تم تحديد المطابقة من خلال معايير أخرى غير مطابقة السلاسل (مثل التصحيحات الإملائية أو عمليات التحويل الصوتي). هذه القيم هي إزاحة أحرف يونيكود للرمز FormattableText.text. يمكن ضمان ترتيب النطاقات بقيم إزاحة متزايدة.
text
النوع:  string
النص الذي يمكن استخدامه كما هو أو تنسيقه باستخدام FormattableText.matches