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])
المَعلمات: 
قيمة العائد:  Promise<AutocompleteResponse>
تستردّ هذه الطريقة عبارات بحث مقترَحة للإكمال التلقائي للأماكن استنادًا إلى طلب الإكمال التلقائي المقدَّم.
getQueryPredictions
getQueryPredictions(request, callback)
المَعلمات: 
القيمة المعروضة:  لا شيء
تستردّ هذه الطريقة عبارات بحث مقترَحة لطلبات البحث استنادًا إلى طلب الإكمال التلقائي المقدَّم.

واجهة AutocompletionRequest

google.maps.places.AutocompletionRequest interface

طلب إكمال تلقائي سيتم إرساله إلى 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 ("نطاق المستوى الأعلى") مكوّنة من حرفَين. تتطابق معظم رموز نطاقات المستوى الأعلى لرمز البلد مع رموز 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 interface

ردّ الإكمال التلقائي الذي تم إرجاعه من خلال طلب إلى AutocompleteService.getPlacePredictions يحتوي على قائمة AutocompletePrediction.
predictions
قائمة AutocompletePrediction

واجهة QueryAutocompletionRequest

google.maps.places.QueryAutocompletionRequest interface

طلب QueryAutocompletion سيتم إرساله إلى 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 interface

google.maps.places.ComponentRestrictions interface

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

واجهة AutocompletePrediction

google.maps.places.AutocompletePrediction interface

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

واجهة QueryAutocompletePrediction

google.maps.places.QueryAutocompletePrediction interface

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

واجهة PredictionTerm

google.maps.places.PredictionTerm interface

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

واجهة PredictionSubstring

google.maps.places.PredictionSubstring interface

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

واجهة StructuredFormatting

google.maps.places.StructuredFormatting interface

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