Places Autocomplete Service

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

completionService الدرجة

google.maps.places.AutocompleteService الصف الدراسي

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

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {AutocompleteService} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

AutocompleteService
AutocompleteService()
المعلّمات: بدون
لإنشاء مثيل جديد من AutocompleteService.
getPlacePredictions
getPlacePredictions(request[, callback])
المعلّمات:
قيمة الإرجاع: Promise<AutocompleteResponse>
لجلب توقعات الإكمال التلقائي للمكان استنادًا إلى طلب الإكمال التلقائي المقدم.
getQueryPredictions
getQueryPredictions(request, callback)
المعلّمات:
قيمة الإرجاع: بدون
لاسترداد توقعات الإكمال التلقائي لطلب البحث استنادًا إلى طلب الإكمال التلقائي لطلب البحث المقدم.

واجهة AutocompleteRequest

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

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

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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.
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
أنواع التوقعات التي سيتم عرضها. لمعرفة الأنواع المتاحة، يُرجى الاطّلاع على دليل المطوِّر. إذا لم يتم تحديد أي أنواع، سيتم عرض جميع الأنواع.

واجهة CompleteResponse

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

استجابة رد تلقائي تم تقديمها من خلال الاتصال بـ AutocompleteService.getPlacePredictions وتحتوي على قائمة تضم AutocompletePrediction.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

predictions

واجهة QueryAutocompletionRequest

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

يتم إرسال طلب QueryAutocompletion إلى QueryAutocompleteService.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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.

فئة completionSessionToken

google.maps.places.AutocompleteSessionToken الصف الدراسي

يمثل رمزًا مميزًا للجلسة يتم استخدامه لتتبُّع جلسة إكمال تلقائي، والتي يمكن أن تكون سلسلة من AutocompleteService.getPlacePredictions مكالمة تليها مكالمة PlacesService.getDetails واحدة.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {AutocompleteSessionToken} = await google.map.importLibrary("places"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

AutocompleteSessionToken
AutocompleteSessionToken()
المعلّمات: بدون
لإنشاء مثيل جديد من AutocompleteSessionToken.

واجهة ComponentRestrictions

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

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

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة برمجة التطبيقات لتوقع الإكمال التلقائي

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

تمثل توقع إكمال تلقائي واحد.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة توقّع الإكمال التلقائي لطلب البحث

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

تمثل هذه الخاصية توقعًا واحدًا للإكمال التلقائي لطلب البحث.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

Predictionterm واجهة

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

تمثل عبارة التوقع.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

PredictionSubstring واجهة

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

تمثل سلسلة فرعية للتوقع.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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

واجهة منظّمة

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

يحتوي على معلومات منظمة حول وصف المكان، مقسّمًا إلى نص رئيسي ونص ثانوي، بما في ذلك مصفوفة من السلاسل الفرعية المطابقة من إدخال الإكمال التلقائي، يتم تحديدها من خلال إزاحة وطول، ويتم التعبير عنها بأحرف unicode.

تحميل باستخدام معلمة عنوان URL &libraries=places. راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

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