Places Autocomplete Service (deprecated)

فئة AutocompleteService

class google.maps.places.AutocompleteService
library "places"

ميزة متوقّفة نهائيًا: اعتبارًا من 1 مارس 2025، لن تكون google.maps.places.AutocompleteService متاحة للعملاء الجدد. يُرجى استخدام AutocompleteSuggestion بدلاً من ذلك. في الوقت الحالي، ليس من المقرّر إيقاف google.maps.places.AutocompleteService نهائيًا، ولكن يُنصح باستخدام AutocompleteSuggestion بدلاً من google.maps.places.AutocompleteService. ستستمر google.maps.places.AutocompleteService في تلقّي إصلاحات الأخطاء لأي حالات تراجُع كبيرة، ولكن لن تتم معالجة الأخطاء الحالية في google.maps.places.AutocompleteService. سيتم إرسال إشعار قبل 12 شهرًا على الأقل من إيقاف الدعم. يُرجى الاطّلاع على https://developers.google.com/maps/legacy للحصول على تفاصيل إضافية وعلى https://developers.google.com/maps/documentation/javascript/places-migration-overview للحصول على دليل نقل البيانات.

تحتوي على طرق مرتبطة باسترداد عبارات البحث المقترَحة من خلال ميزة "الإكمال التلقائي".

const {AutocompleteService} = await google.maps.importLibrary("places");

الشركة المصنِّعة
AutocompleteService	AutocompleteService() المَعلمات: لا تتوفّر أي مَعلمات ينشئ مثيلاً جديدًا من AutocompleteService.

الطُرق
getPlacePredictions	getPlacePredictions(request[, callback]) المَعلمات: ‫request: AutocompletionRequest تمثّل طلب الإكمال التلقائي. ‫callback: function(Array<AutocompletePrediction> optional, PlacesServiceStatus): void optional دالة ردّ اتصال تقبل مصفوفة من عناصر AutocompletePrediction وقيمة PlacesServiceStatus كوسيطة القيمة المعروضة: Promise<AutocompleteResponse> تستردّ عبارات البحث المقترَحة من خلال ميزة "الإكمال التلقائي" للأماكن استنادًا إلى طلب الإكمال التلقائي المقدَّم.
getQueryPredictions	getQueryPredictions(request, callback) المَعلمات: ‫request: QueryAutocompletionRequest طلب الإكمال التلقائي لطلب البحث ‫callback: function(Array<QueryAutocompletePrediction> optional, PlacesServiceStatus): void دالة ردّ اتصال تقبل مصفوفة من عناصر QueryAutocompletePrediction وقيمة PlacesServiceStatus كوسيطة القيمة المعروضة: لا شيء تستردّ عبارات البحث المقترَحة من خلال ميزة &quot;الإكمال التلقائي&quot; استنادًا إلى طلب الإكمال التلقائي المقدَّم.

AutocompletionRequest

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

طلب إكمال تلقائي سيتم إرساله إلى AutocompleteService.getPlacePredictions.

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

واجهة AutocompleteResponse

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

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

الخصائص
predictions	النوع: Array<AutocompletePrediction> قائمة AutocompletePrediction.

واجهة QueryAutocompletionRequest

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

طلب QueryAutocompletion لإرساله إلى QueryAutocompleteService.

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

ComponentRestrictions interface

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

تحدّد هذه السمة قيود المكوّنات التي يمكن استخدامها مع خدمة الإكمال التلقائي.

الخصائص
country اختياري	النوع: 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 اختياري	النوع: number optional المسافة بالأمتار بين المكان وAutocompletionRequest.origin

واجهة QueryAutocompletePrediction

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

تمثّل عبارة بحث مقترَحة واحدة من خلال ميزة "الإكمال التلقائي لطلب البحث".

الخصائص
description	النوع: string هذه هي النسخة غير المنسَّقة من طلب البحث الذي اقترحته خدمة "الأماكن".
matched_substrings	النوع: Array<PredictionSubstring> مجموعة من السلاسل الفرعية في وصف المكان تتطابق مع العناصر في إدخال المستخدم، وهي مناسبة للاستخدام في تمييز تلك السلاسل الفرعية. يتم تحديد كل سلسلة فرعية من خلال إزاحة وطول، ويتم التعبير عنها بأحرف يونيكود.
terms	النوع: Array<PredictionTerm> معلومات حول المصطلحات الفردية في الوصف أعلاه تأتي العبارات الفئوية أولاً (على سبيل المثال، "مطعم"). تظهر عبارات العنوان من الأكثر إلى الأقل تحديدًا. على سبيل المثال، "الرياض" و "المنطقة الوسطى".
place_id اختياري	النوع: 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 هذا هو الجزء النصي الثانوي من الوصف غير المنسَّق للمكان الذي تقترحه خدمة "الأماكن". عادةً ما يكون الموقع الجغرافي للمكان.