Method: places.searchText

البحث عن الأماكن استنادًا إلى طلبات البحث النصية

طلب HTTP

POST https://places.googleapis.com/v1/places:searchText

يستخدم عنوان URL بنية تحويل الترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON
{
  "textQuery": string,
  "languageCode": string,
  "regionCode": string,
  "rankPreference": enum (RankPreference),
  "includedType": string,
  "openNow": boolean,
  "minRating": number,
  "maxResultCount": integer,
  "priceLevels": [
    enum (PriceLevel)
  ],
  "strictTypeFiltering": boolean,
  "locationBias": {
    object (LocationBias)
  },
  "locationRestriction": {
    object (LocationRestriction)
  },
  "evOptions": {
    object (EVOptions)
  }
}
الحقول
textQuery

string

مطلوبة. طلب البحث النصي للبحث النصي.

languageCode

string

سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. إذا كان رمز اللغة غير محدّد أو غير معروف، قد يتم عرض تفاصيل مكان أي لغة، مع تفضيل اللغة الإنجليزية في حال توفّر هذه التفاصيل.

القائمة الحالية باللغات المعتمدة: https://developers.google.com/maps/faq#languagesupport.

regionCode

string

رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي يأتي منه الطلب تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بمنطقة معيّنة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري.

لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

تجدر الإشارة إلى أنّه لا يمكن حاليًا استخدام رموز المناطق المكوَّنة من 3 أرقام.

rankPreference

enum (RankPreference)

كيفية ترتيب النتائج في الردّ

includedType

string

نوع المكان المطلوب. القائمة الكاملة للأنواع المتوافقة: https://developers.google.com/maps/documentation/places/web-service/place-types. يجب استخدام نوع واحد مضمّن فقط.

openNow

boolean

يُستخدم لحصر البحث على الأماكن المفتوحة حاليًا. والقيمة التلقائية هي false.

minRating

number

يمكنك تصفية النتائج التي يقل متوسط تقييم المستخدمين فيها عن هذا الحدّ الأقصى تمامًا. يجب أن تكون القيمة الصالحة عائمة بين 0 و5 (بشكل شامل) بوتيرة 0.5، أي [0، 0.5، 1.0، ... ، 5.0] بشكل شامل. سيتم تقريب تقييم الإدخال إلى أقرب 0.5(سقف). على سبيل المثال، سيؤدي التقييم 0.6 إلى إزالة جميع النتائج ذات التقييم الأقل من 1.0.

maxResultCount

integer

الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20، بشكلٍ شامل. والعدد التلقائي هو 20. وفي حال عدم ضبط الرقم، يعود إلى الحدّ الأقصى المسموح به. إذا تم تعيين الرقم على سالب أو تجاوز الحد الأقصى، يتم عرض خطأ POINTS_{9}.

priceLevels[]

enum (PriceLevel)

يُستخدم لتقييد البحث على الأماكن التي تم وضع علامة عليها كمستويات أسعار معيّنة. يمكن للمستخدمين اختيار أي مجموعات من مستويات الأسعار. اختيار جميع مستويات السعر تلقائيًا

strictTypeFiltering

boolean

يُستخدَم لضبط فلترة الأنواع الصارمة لـincludeType. إذا تم ضبطها على "صحيح"، سيتم عرض النتائج من النوع نفسه فقط. يكون الإعداد التلقائي بالقيمة "خطأ".

locationBias

object (LocationBias)

المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين. لا يمكن الضبط مع locationRestriction.

locationRestriction

object (LocationRestriction)

المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي. لا يمكن الضبط مع locationBias.

evOptions

object (EVOptions)

اختياريّ. ضبط خيارات المركبة الكهربائية القابلة للبحث لطلب البحث عن مكان

نص الاستجابة

نموذج الرد لـ places.searchText.

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON
{
  "places": [
    {
      object (Place)
    }
  ]
}
الحقول
places[]

object (Place)

قائمة بالأماكن التي تستوفي معايير البحث النصي للمستخدِم.

RankPreference

كيفية ترتيب النتائج في الردّ

عمليات التعداد
RANK_PREFERENCE_UNSPECIFIED لم يتم ضبط قيمة RankPreferences. سيتم ضبط القيمة التلقائية على DISTANCE.
DISTANCE يعمل على ترتيب النتائج حسب المسافة.
RELEVANCE يعمل على ترتيب النتائج حسب مدى صلتها بموضوع البحث. يتم تحديد ترتيب الترتيب حسب مكدّس الترتيب العادي.

LocationBias

المنطقة المراد البحث فيها. هذا الموقع بمثابة تحيز مما يعني أنه قد يتم عرض النتائج حول موقع معين.

تمثيل JSON
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  },
  "circle": {
    object (Circle)
  }
  // End of list of possible types for union field type.
}
الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:

rectangle

object (Viewport)

مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة rectangle.high() النقطة الشمالية الشرقية لإطار العرض المستطيل. يجب أن تكون القيمة rectangle.low() عند النقطة الجنوبية الغربية لإطار عرض المستطيل. لا يمكن أن يكون rectangle.low().latitude() أكبر من rectangle.high().latitude(). سينتج عن ذلك نطاق خط عرض فارغ. لا يمكن أن يكون إطار العرض المستطيل أعرض من 180 درجة.

circle

object (Circle)

دائرة محددة بواسطة نقطة المركز ونصف القطر.

LocationRestriction

المنطقة المراد البحث فيها. يمثل هذا الموقع الجغرافي قيدًا مما يعني أنه لن يتم عرض النتائج خارج هذا الموقع الجغرافي.

تمثيل JSON
{

  // Union field type can be only one of the following:
  "rectangle": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
الحقول

حقل الاتحاد type

يمكن أن يكون الحقل "type" واحدًا فقط مما يلي:

rectangle

object (Viewport)

مربع مستطيل يحدد الزاوية الشمالية الشرقية والجنوبية الغربية. يجب أن تكون القيمة rectangle.high() النقطة الشمالية الشرقية لإطار العرض المستطيل. يجب أن تكون القيمة rectangle.low() عند النقطة الجنوبية الغربية لإطار عرض المستطيل. لا يمكن أن يكون rectangle.low().latitude() أكبر من rectangle.high().latitude(). سينتج عن ذلك نطاق خط عرض فارغ. لا يمكن أن يكون إطار العرض المستطيل أعرض من 180 درجة.

EVOptions

خيارات يمكن البحث عنها للمركبة الكهربائية لطلب البحث عن مكان

تمثيل JSON
{
  "minimumChargingRateKw": number,
  "connectorTypes": [
    enum (EVConnectorType)
  ]
}
الحقول
minimumChargingRateKw

number

اختياريّ. فلترة الأماكن حسب الحدّ الأدنى لمعدّل الشحن وتتم فلترة أي أماكن تشحن البطارية فيها أقلّ من الحدّ الأدنى لمعدّل الشحن.

connectorTypes[]

enum (EVConnectorType)

اختياريّ. قائمة بأنواع موصِّلات المركبات الكهربائية المفضّلة يتم استبعاد المكان الذي لا يتيح أيًا من أنواع الموصلات المدرجة.