ابحث عن أماكن بالقرب من المواقع الجغرافية.
طلب 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 ( |
الحقول | |
---|---|
languageCode |
سيتم عرض تفاصيل المكان باللغة المفضّلة إن توفّرت. إذا لم يتم تحديد رمز اللغة أو لم يتم التعرّف عليه، قد يتم عرض تفاصيل مكان أي لغة، مع تفضيل اللغة الإنجليزية في حال توفُّر هذه التفاصيل. يمكنك الاطّلاع على القائمة الحالية للّغات المتوافقة: https://developers.google.com/maps/faq#languagesupport. |
regionCode |
رمز البلد/المنطقة يونيكود (CLDR) للموقع الجغرافي الذي تم تقديم الطلب منه تُستخدَم هذه المَعلمة لعرض تفاصيل المكان، مثل اسم المكان الخاص بالمنطقة، إذا كان متاحًا. يمكن أن تؤثر المَعلمة في النتائج استنادًا إلى القانون الساري. لمزيد من المعلومات، يُرجى الاطّلاع على https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html. يُرجى العلم أنّه لا يمكن حاليًا استخدام رموز المناطق المكوّنة من 3 أرقام. |
includedTypes[] |
تم تضمين نوع المكان (على سبيل المثال، "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. في حال وجود أي أنواع متعارضة، أي ظهر أحد الأنواع في كل من includeTypes وexcludedTypes، يتم عرض الخطأ INVALID_{9}. إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع القيود. على سبيل المثال، في حال كان {includedTypes = [" كبيرة"_]، وexcludedPrimaryTypes = ["مطعم"]}، توفّر الأماكن التي يتم عرضها الخدمات ذات الصلة بالمطعم، ولكنها لا تعمل في المقام الأول كـ "مطاعم". |
excludedTypes[] |
تم استبعاد نوع المكان (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. إذا قدّم العميل كلاً من includeTypes (مثل، مطعم) وexcludedTypes (مثل مقهى)، يجب أن تتضمن الاستجابة الأماكن التي تمثِّل مطعمًا وليس مقهى. يتضمّن الرد أماكن تتطابق مع عنصر واحد على الأقل من includeTypes ولا يتطابق مع أي منها. في حال وجود أي أنواع متعارضة، أي ظهر أحد الأنواع في كل من includeTypes وexcludedTypes، يتم عرض الخطأ INVALID_{9}. إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع القيود. على سبيل المثال، في حال كان {includedTypes = [" كبيرة"_]، وexcludedPrimaryTypes = ["مطعم"]}، توفّر الأماكن التي يتم عرضها الخدمات ذات الصلة بالمطعم، ولكنها لا تعمل في المقام الأول كـ "مطاعم". |
includedPrimaryTypes[] |
تم تضمين نوع المكان الأساسي (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن أن يكون للمكان نوع أساسي واحد فقط من جدول الأنواع المتوافقة المرتبط به. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. في حال كان هناك أي أنواع أساسية متعارضة، على سبيل المثال يظهر أحد الأنواع في كل منincludePrimaryTypes وexcludedPrimaryTypes، يتم عرض خطأ INVALID_{9}. إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع القيود. على سبيل المثال، في حال كان {includedTypes = [" كبيرة"_]، وexcludedPrimaryTypes = ["مطعم"]}، توفّر الأماكن التي يتم عرضها الخدمات ذات الصلة بالمطعم، ولكنها لا تعمل في المقام الأول كـ "مطاعم". |
excludedPrimaryTypes[] |
تم استبعاد نوع المكان الأساسي (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. في حال كان هناك أي أنواع أساسية متعارضة، على سبيل المثال يظهر أحد الأنواع في كل منincludePrimaryTypes وexcludedPrimaryTypes، يتم عرض خطأ INVALID_{9}. إذا تم تحديد نوع مكان مع قيود متعددة الأنواع، لن يتم عرض سوى الأماكن التي تستوفي جميع القيود. على سبيل المثال، في حال كان {includedTypes = [" كبيرة"_]، وexcludedPrimaryTypes = ["مطعم"]}، توفّر الأماكن التي يتم عرضها الخدمات ذات الصلة بالمطعم، ولكنها لا تعمل في المقام الأول كـ "مطاعم". |
maxResultCount |
الحد الأقصى لعدد النتائج المطلوب عرضها. ويجب أن تتراوح القيمة بين 1 و20 (القيمة التلقائية)، ضمنًا. وفي حال عدم ضبط الرقم، يتم الرجوع إلى الحدّ الأقصى. إذا تم تعيين الرقم على سالب أو تجاوز الحد الأقصى، يتم عرض خطأ INVALID_{9}. |
locationRestriction |
مطلوبة. المنطقة المطلوب البحث عنها. |
rankPreference |
كيفية ترتيب النتائج في الردّ |
نص الاستجابة
نموذج الاستجابة للبحث عن الأجهزة المجاورة.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"places": [
{
object ( |
الحقول | |
---|---|
places[] |
قائمة بالأماكن التي تستوفي متطلبات المستخدم، مثل أنواع الأماكن وعدد الأماكن والقيود المفروضة على الموقع الجغرافي المحدّد |
LocationRestriction
المنطقة المطلوب البحث عنها.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن تكون السمة " |
|
circle |
دائرة يتم تحديدها بواسطة نقطة المركز ونصف القطر. |
RankPreference
كيفية ترتيب النتائج في الردّ
عمليات التعداد | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
لم يتم ضبط قيمة RankPreferences. سيتم استخدام الترتيب حسب "شعبية" بشكل تلقائي. |
DISTANCE |
وترتيب النتائج حسب المسافة. |
POPULARITY |
لترتيب النتائج حسب رواجها. |