Places Autocomplete Service

فئة AutocompleteService

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

تحتوي على طرق ذات صلة باسترداد عبارات بحث مقترحة.

يمكنك الوصول من خلال الاتصال على الرقم const {AutocompleteService} = await google.maps.importLibrary("places"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
AutocompleteService
AutocompleteService()
المَعلمات: لا شيء
تنشئ هذه السياسة مثيلاً جديدًا من AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
المَعلمات: 
  • request:  AutocompletionRequest طلب الإكمال التلقائي.
  • callback:  function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional يشير ذلك إلى قبول معاودة الاتصال بمصفوفة من عناصر ميزة إكمال تلقائي للتنبؤ بالإضافة إلى قيمة PlacesServiceStatus كوسيطة.
قيمة الإرجاع:  Promise<AutocompleteResponse>
استرداد توقعات الإكمال التلقائي للأماكن استنادًا إلى طلب الإكمال التلقائي المقدم.
getQueryPredictions
getQueryPredictions(request, callback)
المَعلمات: 
قيمة الإرجاع: لا شيء
لاسترداد توقعات الإكمال التلقائي لطلبات البحث استنادًا إلى طلب الإكمال التلقائي لطلب البحث المقدم.

واجهة AutocompletionRequest

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

سيتم إرسال طلب إكمال تلقائي إلى AutocompleteService.getPlacePredictions.
input
النوع:  string
أدخل المستخدم سلسلة إدخال.
bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
حدود لانحياز التنبؤ. ستكون التوقّعات منحازة، على سبيل المثال لا الحصر، سمة bounds المحدّدة. سيتم تجاهل كل من location وradius في حال ضبط bounds.
componentRestrictions optional
النوع:  ComponentRestrictions optional
القيود على المكوّنات. ويتم استخدام قيود المكونات لتقييد التوقعات على العناصر داخل المكون الرئيسي فقط. على سبيل المثال، البلد.
language optional
النوع:  string optional
تمثّل هذه السمة معرّف اللغة للّغة التي يجب عرض النتائج بها، إذا أمكن. قد يتم منح نتائج البحث باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
location optional
النوع:  LatLng optional
موقع انحياز التنبؤ. ستكون التوقعات منحازة وفقًا للمقياسَين location وradius المحدَّدين. ويمكن بدلاً من ذلك استخدام "bounds".
locationBias optional
النوع:  LocationBias optional
حد مطفي أو تلميح لاستخدامه عند البحث عن أماكن.
locationRestriction optional
النوع:  LocationRestriction optional
قيود لتقييد نتائج البحث.
offset optional
النوع:  number optional
موضع الحرف في مصطلح الإدخال الذي تستخدم فيه الخدمة النص للتوقعات (موضع المؤشر في حقل الإدخال)
origin optional
النوع:  LatLng|LatLngLiteral optional
الموقع الجغرافي الذي يتم احتساب AutocompletePrediction.distance_meters منه.
radius optional
النوع:  number optional
نصف قطر المساحة المستخدمة لانحياز التنبؤ. يتم تحديد radius بالمتر، ويجب أن تكون مصحوبة دائمًا بسمة location. ويمكن بدلاً من ذلك استخدام "bounds".
region optional
النوع:  string optional
رمز منطقة يُستخدم لتنسيق النتائج وفلترة النتائج. ولن يؤدي ذلك إلى حصر الاقتراحات بهذا البلد. يقبل رمز المنطقة قيمة مكوَّنة من حرفين ccTLD ("نطاق المستوى الأعلى"). تتطابق معظم رموز ccTLD مع رموز ISO 3166-1، مع بعض الاستثناءات الملحوظة. على سبيل المثال، نطاق المستوى الأعلى الذي يتم ترميزه حسب البلد (ccTLD) في المملكة المتحدة هو "uk" (.co.uk) في حين أنّ رمز ISO 3166-1 هو "gb" (من الناحية التقنية لكيان "المملكة المتحدة لبريطانيا العظمى وأيرلندا الشمالية").
sessionToken optional
النوع:  AutocompleteSessionToken optional
مرجع فريد يُستخدم لتجميع الطلبات الفردية في جلسات
types optional
النوع:  Array<string> optional
أنواع التوقعات التي سيتم عرضها. ولمعرفة الأنواع المتوافقة، يُرجى الاطّلاع على دليل المطوّر. إذا لم يتمّ تحديد أي أنواع، سيتم عرض جميع الأنواع.

واجهة AutocompleteResponse

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

استجابة إكمال تلقائي ناتجة عن المكالمة إلى AutocompleteService.getPlacePredictions يحتوي على قائمة من AutocompletePrediction.
predictions
قائمة AutocompletePredictions.

واجهة QueryAutocompletionRequest

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

طلب QueryAutocomplete لإرساله إلى QueryAutocompleteService.
input
النوع:  string
أدخل المستخدم سلسلة إدخال.
bounds optional
النوع:  LatLngBounds|LatLngBoundsLiteral optional
حدود لانحياز التنبؤ. ستكون التوقّعات منحازة، على سبيل المثال لا الحصر، سمة bounds المحدّدة. سيتم تجاهل كل من location وradius في حال ضبط bounds.
location optional
النوع:  LatLng optional
موقع انحياز التنبؤ. ستكون التوقعات منحازة وفقًا للمقياسَين location وradius المحدَّدين. ويمكن بدلاً من ذلك استخدام "bounds".
offset optional
النوع:  number optional
موضع الحرف في مصطلح الإدخال الذي تستخدم فيه الخدمة النص للتوقعات (موضع المؤشر في حقل الإدخال)
radius optional
النوع:  number optional
نصف قطر المساحة المستخدمة لانحياز التنبؤ. يتم تحديد radius بالمتر، ويجب أن تكون مصحوبة دائمًا بسمة location. ويمكن بدلاً من ذلك استخدام "bounds".

واجهة ComponentRestrictions

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

تحدِّد هذه السياسة القيود المفروضة على المكوّنات التي يمكن استخدامها مع خدمة الإكمال التلقائي.
country optional
النوع:  string|Array<string> optional
يتم حصر التوقعات على البلد المحدد (رمز البلد ISO 3166-1 Alpha-2، غير حساس لحالة الأحرف). على سبيل المثال، 'us' أو 'br' أو 'au'. ويمكنك توفير سلسلة واحدة أو مصفوفة تضمّ ما يصل إلى خمس سلاسل لرموز البلدان.

واجهة AutocompletePrediction

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

تمثل هذه السمة عبارة بحث مقترحة واحدة للإكمال التلقائي.
description
النوع:  string
هذه هي النسخة غير المنسقة من طلب البحث الذي اقترحته خدمة الأماكن.
matched_substrings
النوع:  Array<PredictionSubstring>
مجموعة من السلاسل الفرعية في وصف المكان التي تتطابق مع عناصر في البيانات التي أدخلها المستخدم، وهي مناسبة للاستخدام في تمييز هذه السلاسل الفرعية. يتم تحديد كل سلسلة فرعية من خلال إزاحة وطول، ويتم التعبير عنها بأحرف يونيكود.
place_id
النوع:  string
معرّف مكان يمكن استخدامه لاسترداد تفاصيل حول هذا المكان باستخدام خدمة تفاصيل المكان (راجِع PlacesService.getDetails).
structured_formatting
النوع:  StructuredFormatting
معلومات منظَّمة عن وصف المكان، مقسمة إلى نص رئيسي ونص ثانوي، بما في ذلك مصفوفة من السلاسل الفرعية المطابقة من إدخال الإكمال التلقائي، التي يتم تحديدها بواسطة إزاحة وطول، مع التعبير عنها بأحرف يونيكود.
terms
النوع:  Array<PredictionTerm>
معلومات حول العبارات الفردية في الوصف أعلاه، من الأكثر إلى الأقل تحديدًا. على سبيل المثال، "Taco Bell" و"Willitis" و "CA".
types
النوع:  Array<string>
مصفوفة من الأنواع التي تنتمي إليها عبارة البحث المقترحة، مثل 'establishment' أو 'geocode'.
distance_meters optional
النوع:  number optional
المسافة بالأمتار من المكان من AutocompletionRequest.origin.

واجهة QueryAutocompletePrediction

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

يمثل توقعًا واحدًا للإكمال التلقائي لطلب البحث.
description
النوع:  string
هذه هي النسخة غير المنسقة من طلب البحث الذي اقترحته خدمة الأماكن.
matched_substrings
النوع:  Array<PredictionSubstring>
مجموعة من السلاسل الفرعية في وصف المكان التي تتطابق مع عناصر في البيانات التي أدخلها المستخدم، وهي مناسبة للاستخدام في تمييز هذه السلاسل الفرعية. يتم تحديد كل سلسلة فرعية من خلال إزاحة وطول، ويتم التعبير عنها بأحرف يونيكود.
terms
النوع:  Array<PredictionTerm>
معلومات حول العبارات الفردية في الوصف أعلاه. يأتي المصطلحات الفئوية في المقام الأول (على سبيل المثال، "مطعم"). تظهر مصطلحات العناوين من الأكثر إلى الأقل تحديدًا. على سبيل المثال، "سان فرانسيسكو" و "CA".
place_id optional
النوع:  string optional
لا يتوفّر هذا الخيار إلا إذا كان التوقّع عبارة عن مكان. معرّف مكان يمكن استخدامه لاسترداد تفاصيل حول هذا المكان باستخدام خدمة تفاصيل المكان (راجِع PlacesService.getDetails).

واجهة PredictionTerm

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

تمثل هذه السمة عبارة توقّع.
offset
النوع:  number
إزاحة بداية هذا المصطلح في وصف المكان، بأحرف يونيكود.
value
النوع:  string
قيمة هذه المصطلح، مثل "Taco Bell".

واجهة PredictionSubstring

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

تمثّل هذه السمة سلسلة فرعية للتوقّع.
length
النوع:  number
طول السلسلة الفرعية.
offset
النوع:  number
الإزاحة لبداية السلسلة الفرعية داخل سلسلة الوصف.

واجهة StructuredFormatting

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

يحتوي على معلومات منظَّمة حول وصف المكان، مقسمة إلى نص رئيسي ونص ثانوي، بما في ذلك مصفوفة من السلاسل الفرعية المطابقة من إدخال الإكمال التلقائي، والتي يتم تحديدها بواسطة إزاحة وطول، ويتم التعبير عنها بأحرف يونيكود.
main_text
النوع:  string
هذا هو جزء النص الرئيسي من الوصف غير المنسَّق للمكان الذي اقترحته خدمة الأماكن. عادةً ما يكون اسم المكان.
main_text_matched_substrings
النوع:  Array<PredictionSubstring>
مجموعة من السلاسل الفرعية في النص الرئيسي التي تطابق عناصر في إدخال المستخدم، وهي مناسبة للاستخدام في تمييز تلك السلاسل الفرعية. يتم تحديد كل سلسلة فرعية من خلال إزاحة وطول، ويتم التعبير عنها بأحرف يونيكود.
secondary_text
النوع:  string
هذا هو جزء النص الثانوي من الوصف غير المنسَّق للمكان الذي اقترحته خدمة الأماكن. عادةً ما تمثّل هذه السمة موقع المكان.