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,
  "pageSize": integer,
  "pageToken": string,
  "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
(deprecated)

integer

متوقّفة نهائيًا: استخدِم pageSize بدلاً منها.

تمثّل هذه السمة الحدّ الأقصى لعدد النتائج التي يمكن عرضها في كل صفحة. إذا كان عدد النتائج المتاحة أكبر من maxResultCount، يتم عرض nextPageToken ويمكن تمريره إلى pageToken للحصول على الصفحة التالية من النتائج في الطلبات اللاحقة. في حال تقديم القيمة 0 أو عدم تقديم أي قيمة، يتم استخدام القيمة التلقائية 20. الحد الأقصى للقيمة هو 20؛ سيتم فرض القيم فوق 20 على 20. ستعرض القيم السالبة خطأ غير صالح.

إذا تم تحديد كل من maxResultCount وpageSize، سيتم تجاهل maxResultCount.
pageSize

integer

اختياريّ. تمثّل هذه السمة الحدّ الأقصى لعدد النتائج التي يمكن عرضها في كل صفحة. إذا كان عدد النتائج المتاحة أكبر من pageSize، يتم عرض nextPageToken ويمكن تمريره إلى pageToken للحصول على الصفحة التالية من النتائج في الطلبات اللاحقة. في حال تقديم القيمة 0 أو عدم تقديم أي قيمة، يتم استخدام القيمة التلقائية 20. الحد الأقصى للقيمة هو 20؛ القيم الأعلى من 20 سيتم تعيينها على 20. ستعرض القيم السالبة خطأ غير صالح.

إذا تم تحديد كل من maxResultCount وpageSize، سيتم تجاهل maxResultCount.
pageToken

string

اختياريّ. رمز مميّز للصفحة، تم تلقّيه من استدعاء سابق عبر ميزة TextSearch. يمكنك توفير هذا الحقل لاسترداد الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المعلمات، باستثناء pageToken وpageSize، وmaxResultCount، التي يتم تقديمها إلى TextSearch، مع الاستدعاء الأولي الذي قدّم الرمز المميز للصفحة. وخلاف ذلك، يتم عرض خطأ ضياء_فياكن.
priceLevels[]

enum (PriceLevel)

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

boolean

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

object (LocationBias)

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

object (LocationRestriction)

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

object (EVOptions)

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

نص الاستجابة

نموذج الاستجابة لـ places.searchText.

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

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

object (Place)

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

object (ContextualContent)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

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

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. إذا تم إسقاط هذا الحقل أو تركه فارغًا، فلن تظهر أي صفحات لاحقة.

RankPreference

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

عمليات التعداد
RANK_PREFERENCE_UNSPECIFIED بالنسبة إلى طلب بحث فئوي مثل "مطاعم في دبي"، يكون RELEVANCE هو الإعداد الافتراضي. لطلبات البحث غير الفئوية، مثل "Mountain View, CA" ننصحك بترك RankPreference بدون تحديد
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)

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

ContextualContent

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

المحتوى المرتبط بطلب البحث عن المكان

تمثيل JSON 
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "photos": [
    {
      object (Photo)
    }
  ],
  "justifications": [
    {
      object (Justification)
    }
  ]
}
الحقول
reviews[]

object (Review)

قائمة المراجعات حول هذا المكان تظهر بشكل متتابع مع طلب البحث عن المكان
photos[]

object (Photo)

معلومات (بما في ذلك المراجع) عن صور هذا المكان تظهر بشكل متواصل مع طلب البحث عن المكان
justifications[]

object (Justification)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

مبررات المكان.

السبب

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

مبررات المكان. تجيب التبريرات على سؤال سبب أهمية المكان للمستخدم النهائي.

تمثيل JSON 
{

  // Union field justification can be only one of the following:
  "reviewJustification": {
    object (ReviewJustification)
  },
  "businessAvailabilityAttributesJustification": {
    object (BusinessAvailabilityAttributesJustification)
  }
  // End of list of possible types for union field justification.
}
الحقول

حقل الاتحاد justification.

يمكن أن يكون justification واحدًا فقط مما يلي:
reviewJustification

object (ReviewJustification)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.
businessAvailabilityAttributesJustification

object (BusinessAvailabilityAttributesJustification)

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

ReviewJustification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل.

مبررات مراجعة المستخدمين: يبرز هذا قسمًا من مراجعة المستخدم قد يهم المستخدم النهائي. على سبيل المثال، إذا كان طلب البحث هو "بيتزا مخبوزة"، يبرز مبرر المراجعة النص ذي الصلة بطلب البحث.

تمثيل JSON 
{
  "highlightedText": {
    object (HighlightedText)
  },
  "review": {
    object (Review)
  }
}
الحقول
highlightedText

object (HighlightedText)
review

object (Review)

المراجعة التي تم إنشاء النص المميّز منها

HighlightedText

النص الذي يتم تمييزه من خلال التبرير. هذه مجموعة فرعية من المراجعة نفسها. يتم تمييز الكلمة التي يجب تمييزها بالضبط من خلال MarkedTextRange. قد يكون هناك عدة كلمات في النص الذي يتم تمييزه.

تمثيل JSON 
{
  "text": string,
  "highlightedTextRanges": [
    {
      object (HighlightedTextRange)
    }
  ]
}
الحقول
text

string
highlightedTextRanges[]

object (HighlightedTextRange)

قائمة نطاقات النص المميّز

HighlightedTextRange

نطاق النص المميّز.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer
}
الحقول
startIndex

integer
endIndex

integer

BusinessAvailabilityAttributesJustification

ميزة تجريبية: يُرجى الاطّلاع على https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative للحصول على مزيد من التفاصيل. مبرّرات BusinessAvailabilityAttributes. يعرض ذلك بعض السمات التي يمتلكها النشاط التجاري والتي قد تهم المستخدم النهائي.

تمثيل JSON 
{
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean
}
الحقول
takeout

boolean

إذا كان المكان يقدّم خدمة طلب الوجبات لتناولها خارج المطعم
delivery

boolean

إذا كان المكان يقدّم خدمة توصيل الطلبات
dineIn

boolean

إذا كان المكان يوفّر خدمة تناول الطعام داخله