البحث عن الأماكن استنادًا إلى طلبات البحث النصية
طلب HTTP
POST https://places.googleapis.com/v1/places:searchText
يستخدم عنوان URL بنية تحويل الترميز gRPC.
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "textQuery": string, "languageCode": string, "regionCode": string, "rankPreference": enum ( |
الحقول | |
---|---|
textQuery |
مطلوبة. طلب البحث النصي للبحث النصي. |
languageCode |
سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. إذا كان رمز اللغة غير محدّد أو غير معروف، قد يتم عرض تفاصيل مكان أي لغة، مع تفضيل اللغة الإنجليزية في حال توفّر هذه التفاصيل. القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام. |
rankPreference |
كيفية ترتيب النتائج في الردّ |
includedType |
نوع المكان المطلوب. القائمة الكاملة للأنواع المتوافقة: https://developers.google.com/maps/documentation/places/web-service/place-types. يجب استخدام نوع واحد مضمّن فقط. |
openNow |
يُستخدم لحصر البحث على الأماكن المفتوحة حاليًا. والقيمة التلقائية هي false. |
minRating |
يمكنك تصفية النتائج التي يقل متوسط تقييم المستخدمين فيها عن هذا الحدّ الأقصى تمامًا. يجب أن تكون القيمة الصالحة عائمة بين 0 و5 (بشكل شامل) بوتيرة 0.5، أي [0، 0.5، 1.0، ... ، 5.0] بشكل شامل. سيتم تقريب تقييم الإدخال إلى أقرب 0.5(سقف). على سبيل المثال، سيؤدي التقييم 0.6 إلى إزالة جميع النتائج ذات التقييم الأقل من 1.0. |
maxResultCount |
الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20، بشكلٍ شامل. والعدد التلقائي هو 20. وفي حال عدم ضبط الرقم، يعود إلى الحدّ الأقصى المسموح به. إذا تم تعيين الرقم على سالب أو تجاوز الحد الأقصى، يتم عرض خطأ POINTS_{9}. |
priceLevels[] |
يُستخدم لتقييد البحث على الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. يمكن للمستخدمين اختيار أي مجموعات من مستويات الأسعار. اختيار جميع مستويات السعر تلقائيًا |
strictTypeFiltering |
يُستخدَم لضبط فلترة الأنواع الصارمة لـincludeType. إذا تم ضبطها على "صحيح"، سيتم عرض النتائج من النوع نفسه فقط. يكون الإعداد التلقائي بالقيمة "خطأ". |
locationBias |
المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين. لا يمكن الضبط مع locationRestriction. |
locationRestriction |
المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي. لا يمكن الضبط مع locationBias. |
evOptions |
اختياريّ. ضبط خيارات المركبة الكهربائية القابلة للبحث لطلب البحث عن مكان |
نص الاستجابة
نموذج الرد لـ places.searchText.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"places": [
{
object ( |
الحقول | |
---|---|
places[] |
قائمة بالأماكن التي تستوفي معايير البحث النصي للمستخدِم. |
RankPreference
كيفية ترتيب النتائج في الردّ
عمليات التعداد | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
بالنسبة إلى استعلام فئوي مثل "مطاعم في مدينة نيويورك"، يكون RELEVANCE الافتراضي هو. بالنسبة إلى طلبات البحث غير الفئوية، مثل "Mountain View, CA"، ننصحك بترك المفضلة بدون ضبط. |
DISTANCE |
يعمل على ترتيب النتائج حسب المسافة. |
RELEVANCE |
يعمل على ترتيب النتائج حسب مدى صلتها بموضوع البحث. يتم تحديد ترتيب الترتيب حسب مكدّس الترتيب العادي. |
LocationBias
المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
rectangle |
مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة |
circle |
دائرة محددة بواسطة نقطة المركز ونصف القطر. |
LocationRestriction
المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون الحقل " |
|
rectangle |
مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة |
EVOptions
خيارات يمكن البحث عنها للمركبة الكهربائية لطلب البحث عن مكان
تمثيل JSON |
---|
{
"minimumChargingRateKw": number,
"connectorTypes": [
enum ( |
الحقول | |
---|---|
minimumChargingRateKw |
اختياريّ. الحد الأدنى لمعدل الشحن المطلوب بالكيلوواط تتم فلترة المكان الذي يكون معدّل الشحن أقل من المعدّل المحدّد. |
connectorTypes[] |
اختياريّ. قائمة بأنواع موصِّلات المركبات الكهربائية المفضّلة يتم استبعاد المكان الذي لا يتيح أيًا من أنواع الموصلات المدرجة. |