Method: places.searchNearby

البحث عن أماكن بالقرب من المواقع الجغرافية

طلب HTTP

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

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

نص الطلب

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

تمثيل JSON
{
  "languageCode": string,
  "regionCode": string,
  "includedTypes": [
    string
  ],
  "excludedTypes": [
    string
  ],
  "includedPrimaryTypes": [
    string
  ],
  "excludedPrimaryTypes": [
    string
  ],
  "maxResultCount": integer,
  "locationRestriction": {
    object (LocationRestriction)
  },
  "rankPreference": enum (RankPreference)
}
الحقول
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 أرقام غير متاحة حاليًا.

includedTypes[]

string

تم تضمين نوع المكان (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ.

في حال وجود أي أنواع متعارضة، بمعنى ظهور نوع معيَّن في كلٍ منincludeincludes وexcludedTypes، فسيتم عرض خطأ ضياء_أمل.

إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم".

excludedTypes[]

string

نوع المكان المستبعَد (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ.

إذا قدّم العميل كلاً من partnerTypes (مثل مطعم) وأنواع مستبعدة (مثل مقهى)، يجب أن يتضمن الرد أماكن تقع في نطاق المطاعم وليس مقهى. يتضمن الردّ أماكن تتطابق مع نوع واحد على الأقل من أنواع البيانات المضمَّنة ولا يتضمن أيًا من الأنواع المستبعدَة.

في حال وجود أي أنواع متعارضة، بمعنى ظهور نوع معيَّن في كلٍ منincludeincludes وexcludedTypes، فسيتم عرض خطأ ضياء_أمل.

إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم".

includedPrimaryTypes[]

string

تم تضمين نوع المكان الأساسي (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن أن يحتوي المكان على نوع أساسي واحد فقط من جدول الأنواع المتوافقة المرتبط به.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ.

في حال وجود أي أنواع أساسية متعارضة، بمعنى ظهور نوع ما في كلٍ من partnerPrimaryTypes وexcludedPrimaryTypes، سيتم عرض خطأ ضياء_أمل.

إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم".

excludedPrimaryTypes[]

string

نوع المكان الأساسي الذي تم استبعاده (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types.

يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ.

في حال وجود أي أنواع أساسية متعارضة، بمعنى ظهور نوع ما في كلٍ من partnerPrimaryTypes وexcludedPrimaryTypes، سيتم عرض خطأ ضياء_أمل.

إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم".

maxResultCount

integer

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

locationRestriction

object (LocationRestriction)

مطلوب. المنطقة التي تريد البحث فيها.

rankPreference

enum (RankPreference)

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

نص الاستجابة

نموذج الاستجابة للبحث عن الأجهزة المجاورة

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

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

object (Place)

قائمة بالأماكن التي تستوفي متطلبات المستخدم، مثل أنواع الأماكن وعدد الأماكن والقيود المحدّدة على الموقع الجغرافي

LocationRestriction

المنطقة التي تريد البحث فيها.

تمثيل JSON
{

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

حقل الاتحاد type.

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

circle

object (Circle)

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

RankPreference

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

عمليات التعداد
RANK_PREFERENCE_UNSPECIFIED لم يتم ضبط قيمة RankPreference. سيتم استخدام "الترتيب حسب "POPULARITY" بشكلٍ تلقائي.
DISTANCE لترتيب النتائج حسب المسافة.
POPULARITY لترتيب النتائج حسب مدى رواجها.