واجهة AutocompleteRequest
واجهة google.maps.places.AutocompleteRequest
واجهة الطلب لـ AutocompleteSuggestion.fetchAutocompleteSuggestions
أماكن إقامة | |
---|---|
input |
النوع:
string السلسلة النصية المطلوب البحث فيها. |
includedPrimaryTypes optional |
النوع:
Array<string> optional تم تضمين نوع المكان الأساسي (مثل "مطعم" أو "محطة غاز"). لا يتم عرض مكان إلا إذا كان نوعه الأساسي مُدرَجًا في هذه القائمة. ويمكن تحديد ما يصل إلى 5 قيم. وإذا لم يتم تحديد أي أنواع، سيتم عرض جميع أنواع الأماكن. |
includedRegionCodes optional |
النوع:
Array<string> optional يمكنك تضمين النتائج في المناطق المحدّدة فقط، والمحدّدة على أنّها رموز مناطق مؤلفة من حرفَين يصل عددها إلى 15 رمز CLDR. لن تؤدي المجموعة الفارغة إلى تقييد النتائج. إذا تم ضبط كل من locationRestriction وincludedRegionCodes ، ستظهر النتائج في منطقة التقاطع. |
inputOffset optional |
النوع:
number optional إزاحة أحرف Unicode بدون قيمة input للإشارة إلى موضع المؤشر في input قد يؤثر موضع المؤشر على التوقعات التي يتم عرضها. إذا لم يتم تحديد قيمة، سيتم ضبط القيمة التلقائية على طول السمة input . |
language optional |
النوع:
string optional اللغة التي يتم عرض النتائج بها. سيتم ضبط الإعدادات التلقائية على تفضيل اللغة في المتصفح. قد تكون النتائج بلغات مختلطة إذا كانت اللغة المستخدمة في input مختلفة عن language ، أو إذا لم تتم ترجمة المكان الذي تم إرجاعه من اللغة المحلية إلى language . |
locationBias optional |
النوع:
LocationBias optional يؤدي التحيز إلى موقع محدد. يجب ضبط قيمة واحدة على الأكثر من locationBias أو locationRestriction . وإذا لم يتم تعيين أي منهما، ستكون النتائج متحيزة بعنوان IP، مما يعني أنه سيتم تعيين عنوان IP لموقع غير دقيق واستخدامه كإشارة تحيز. |
locationRestriction optional |
النوع:
LocationRestriction optional حصر النتائج في مكان محدّد يجب ضبط قيمة واحدة على الأكثر من locationBias أو locationRestriction . وإذا لم يتم تعيين أي منهما، ستكون النتائج متحيزة بعنوان IP، مما يعني أنه سيتم تعيين عنوان IP لموقع غير دقيق واستخدامه كإشارة تحيز. |
origin optional |
النوع:
LatLng|LatLngLiteral optional نقطة الأصل المطلوب حساب المسافة الجيوديسية منها إلى الوجهة (يتم عرضها كـ PlacePrediction.distanceMeters ). في حال حذف هذه القيمة، لن يتم عرض المسافة الجيوديسية. |
region optional |
النوع:
string optional تمثّل هذه السمة رمز المنطقة، ويتم تحديده كرمز منطقة مؤلف من حرفين CLDR. ويؤثر هذا في تنسيق العنوان وترتيب النتائج وقد يؤثر في النتائج التي يتم عرضها. لا يؤدي ذلك إلى حصر النتائج بالمنطقة المحدّدة. |
sessionToken optional |
النوع:
AutocompleteSessionToken optional رمز مميّز يحدّد جلسة الإكمال التلقائي لأغراض الفوترة أنشئ رمزًا مميّزًا جديدًا للجلسة من خلال AutocompleteSessionToken . تبدأ الجلسة عندما يبدأ المستخدم في كتابة طلب بحث، وتنتهي عند اختيار مكان وإجراء مكالمة مع " Place.fetchFields ". يمكن أن تحتوي كل جلسة على طلبات بحث متعددة، متبوعة بمكالمة fetchFields واحدة. يجب أن تنتمي بيانات الاعتماد المستخدَمة لكل طلب خلال جلسة إلى المشروع نفسه على Google Cloud Console. بعد انتهاء الجلسة، لن يصبح الرمز المميّز صالحًا، بل يجب أن ينشئ تطبيقك رمزًا مميّزًا جديدًا لكل جلسة. إذا تم حذف مَعلمة sessionToken أو إذا أعدت استخدام رمز مميَّز للجلسة، يتم تحصيل رسوم الجلسة كما لو لم يتم تقديم رمز مميّز للجلسة (تتم فوترة كل طلب على حدة). ننصح باتّباع الإرشادات التالية:
|
AutocompleteSessionToken
صف واحد (google.maps.places.AutocompleteSessionToken
)
يمثل ذلك الرمز المميز للجلسة المستخدم لتتبع جلسة إكمال تلقائي.
بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {AutocompleteSessionToken} = await google.maps.importLibrary("places")
. اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
الشركة المصنِّعة | |
---|---|
AutocompleteSessionToken |
AutocompleteSessionToken() المَعلمات: ما مِن مَعلمات
تنشئ مثيلاً جديدًا من AutocompleteSessionToken . |
AutocompleteSuggestion
صف واحد (google.maps.places.AutocompleteSuggestion
)
نتيجة اقتراح إكمال تلقائي
بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {AutocompleteSuggestion} = await google.maps.importLibrary("places")
. اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
طرق ثابتة | |
---|---|
fetchAutocompleteSuggestions |
fetchAutocompleteSuggestions(autocompleteRequest) المَعلمات:
القيمة المعروضة:
Promise<{suggestions:Array<AutocompleteSuggestion>}> لجلب قائمة باقتراحات الإكمال التلقائي |
أماكن إقامة | |
---|---|
placePrediction |
النوع:
PlacePrediction optional يحتوي على اسم يمكن لشخص عادي قراءته للنتيجة المعروضة. في ما يتعلّق بنتائج المؤسسات، يكون عادةً اسم النشاط التجاري وعنوانه. |
PlacePrediction المستوى
صف واحد (google.maps.places.PlacePrediction
)
نتائج التوقّعات لتوقّعات الإكمال التلقائي لمكان
بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {PlacePrediction} = await google.maps.importLibrary("places")
. اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
أماكن إقامة | |
---|---|
distanceMeters |
النوع:
number optional طول العنصر الجيوديسي بالمتر من origin إذا تم تحديد origin . |
mainText |
النوع:
FormattableText optional يمثل اسم المكان. |
placeId |
النوع:
string المعرّف الفريد للمكان المقترَح. يمكن استخدام هذا المعرّف في واجهات برمجة التطبيقات الأخرى التي تقبل أرقام تعريف الأماكن. |
secondaryText |
النوع:
FormattableText optional تُمثِّل عناصر إضافية واضحة (مثل مدينة أو منطقة) لتحديد المكان بشكلٍ أكبر. |
text |
النوع:
FormattableText يحتوي على اسم يمكن لشخص عادي قراءته للنتيجة المعروضة. في ما يتعلّق بنتائج المؤسسات، يكون عادةً اسم النشاط التجاري وعنوانه. يُنصح باستخدام text للمطوّرين الذين يريدون عرض عنصر واحد في واجهة المستخدم. إذا أراد المطوّرون عرض عنصرَين منفصلَين ولكن مترابطَين في واجهة المستخدم، قد يحتاجون إلى استخدام PlacePrediction.mainText وPlacePrediction.secondaryText بدلاً من ذلك. |
types |
النوع:
Array<string> قائمة الأنواع التي تنطبق على هذا المكان من الجدول "أ" أو الجدول "ب" في https://developers.google.com/maps/documentation/places/web-service/place-types. |
الطُرق | |
---|---|
toPlace |
toPlace() المَعلمات: ما مِن مَعلمات
القيمة المعروضة:
Place تعرض تمثيلاً لمكان ميزة "توقّع المكان" هذا. يلزم إجراء مكالمة لاحقة إلى Place.fetchFields للحصول على التفاصيل الكاملة للمكان. |
StringRange
صف واحد (google.maps.places.StringRange
)
تحدد هذه السمة سلسلة فرعية ضمن نص معين.
بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {StringRange} = await google.maps.importLibrary("places")
. اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
أماكن إقامة | |
---|---|
endOffset |
النوع:
number إزاحة قائمة على الصفر لآخر حرف يونيكود في السلسلة الفرعية (حصريًا). |
startOffset |
النوع:
number إزاحة قائمة على الصفر لأول حرف يونيكود من السلسلة الفرعية (شاملة). |
FormattableText
صف واحد (google.maps.places.FormattableText
)
نص يمثّل عبارة بحث مقترحة مكان يمكن استخدام النص كما هو أو منسَّق.
بإمكانك الوصول إلى الخدمة من خلال الاتصال بالرقم const {FormattableText} = await google.maps.importLibrary("places")
. اطّلع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
أماكن إقامة | |
---|---|
matches |
النوع:
Array<StringRange> قائمة بنطاقات السلاسل التي تحدد مكان مطابقة طلب الإدخال في FormattableText.text . يمكن استخدام النطاقات لتنسيق أجزاء معيّنة من text . وقد لا تكون السلاسل الفرعية متطابقة تمامًا مع AutocompleteRequest.input إذا تم تحديد المطابقة من خلال معايير أخرى غير مطابقة السلاسل (مثل التصحيحات الإملائية أو عمليات التحويل الصوتي). هذه القيم هي إزاحة أحرف يونيكود للرمز FormattableText.text . يمكن ضمان ترتيب النطاقات بقيم إزاحة متزايدة. |
text |
النوع:
string النص الذي يمكن استخدامه كما هو أو تنسيقه باستخدام FormattableText.matches |