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 نوعًا من الجدول أ.

في حال وجود أي أنواع متعارضة، أي ظهر أحد الأنواع في كل من includeTypes وexcludedTypes، يتم عرض الخطأ INVALID_{9}.

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

string

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

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

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

في حال وجود أي أنواع متعارضة، أي ظهر أحد الأنواع في كل من includeTypes وexcludedTypes، يتم عرض الخطأ INVALID_{9}.

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

string

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

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

في حال كان هناك أي أنواع أساسية متعارضة، على سبيل المثال يظهر أحد الأنواع في كل منincludePrimaryTypes وexcludedPrimaryTypes، يتم عرض خطأ INVALID_{9}.

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

string

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

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

في حال كان هناك أي أنواع أساسية متعارضة، على سبيل المثال يظهر أحد الأنواع في كل منincludePrimaryTypes وexcludedPrimaryTypes، يتم عرض خطأ INVALID_{9}.

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

integer

الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20 (القيمة التلقائية)، ضمنًا. وفي حال عدم ضبط الرقم، يتم الرجوع إلى الحدّ الأقصى. إذا تم تعيين الرقم على سالب أو تجاوز الحد الأقصى، يتم عرض خطأ INVALID_{9}.
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 لم يتم ضبط قيمة RankPreferences. سيتم استخدام الترتيب حسب "شعبية" بشكل تلقائي.
DISTANCE وترتيب النتائج حسب المسافة.
POPULARITY لترتيب النتائج حسب رواجها.