Places Autocomplete Service

فئة AutocompleteService

google.maps.places.AutocompleteService صف

إيقاف نهائي: اعتبارًا من 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").
اطّلِع على المكتبات في Maps JavaScript API.

الشركة المصنِّعة
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 كمعلَمة. القيمة المعروضة:  لا شيء تستردّ هذه الطريقة عبارات بحث مقترَحة لطلبات البحث استنادًا إلى طلب الإكمال التلقائي المقدَّم.

واجهة AutocompletionRequest

google.maps.places.AutocompletionRequest interface

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

الخصائص
input	النوع:  string أدخل المستخدم سلسلة إدخال.
bounds optional	تم إيقافها نهائيًا: تم إيقاف bounds نهائيًا اعتبارًا من مايو 2023. يُرجى استخدام AutocompletionRequest.locationBias وAutocompletionRequest.locationRestriction بدلاً منها. النوع:  LatLngBounds|LatLngBoundsLiteral optional حدود انحياز التوقّعات ستكون التوقعات متحيزة نحو bounds المحدّد، ولكن لن تقتصر عليه. سيتم تجاهل كل من location وradius في حال ضبط bounds.
componentRestrictions optional	النوع:  ComponentRestrictions optional قيود المكوّن تُستخدَم قيود المكوّنات لحصر التوقّعات على تلك التي تقع ضمن المكوّن الرئيسي فقط. على سبيل المثال، البلد.
language optional	النوع:  string optional معرّف اللغة التي يجب عرض النتائج بها، إذا كان ذلك ممكنًا قد يتم منح النتائج باللغة المحدّدة ترتيبًا أعلى، ولكن لا تقتصر الاقتراحات على هذه اللغة. اطّلِع على قائمة اللغات المتاحة.
location optional	تم إيقافها نهائيًا: تم إيقاف location نهائيًا اعتبارًا من مايو 2023. يُرجى استخدام AutocompletionRequest.locationBias وAutocompletionRequest.locationRestriction بدلاً منها. النوع:  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	تم إيقافها نهائيًا: تم إيقاف radius نهائيًا اعتبارًا من مايو 2023. يُرجى استخدام AutocompletionRequest.locationBias وAutocompletionRequest.locationRestriction بدلاً منها. النوع:  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	النوع:  Array<AutocompletePrediction> قائمة 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". تمثّل هذه السمة عادةً الموقع الجغرافي للمكان.