البحث عن أماكن بالقرب من المواقع الجغرافية
طلب 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 نوعًا من الجدول أ. في حال وجود أي أنواع متعارضة، بمعنى ظهور نوع معيَّن في كلٍ منincludeincludes وexcludedTypes، فسيتم عرض خطأ ضياء_أمل. إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم". |
excludedTypes[] |
نوع المكان المستبعَد (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. إذا قدّم العميل كلاً من partnerTypes (مثل مطعم) وأنواع مستبعدة (مثل مقهى)، يجب أن يتضمن الرد أماكن تقع في نطاق المطاعم وليس مقهى. يتضمن الردّ أماكن تتطابق مع نوع واحد على الأقل من أنواع البيانات المضمَّنة ولا يتضمن أيًا من الأنواع المستبعدَة. في حال وجود أي أنواع متعارضة، بمعنى ظهور نوع معيَّن في كلٍ منincludeincludes وexcludedTypes، فسيتم عرض خطأ ضياء_أمل. إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم". |
includedPrimaryTypes[] |
تم تضمين نوع المكان الأساسي (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن أن يحتوي المكان على نوع أساسي واحد فقط من جدول الأنواع المتوافقة المرتبط به. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. في حال وجود أي أنواع أساسية متعارضة، بمعنى ظهور نوع ما في كلٍ من partnerPrimaryTypes وexcludedPrimaryTypes، سيتم عرض خطأ ضياء_أمل. إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم". |
excludedPrimaryTypes[] |
نوع المكان الأساسي الذي تم استبعاده (مثل "مطعم" أو "gas_station") من https://developers.google.com/maps/documentation/places/web-service/place-types. يمكن تحديد ما يصل إلى 50 نوعًا من الجدول أ. في حال وجود أي أنواع أساسية متعارضة، بمعنى ظهور نوع ما في كلٍ من partnerPrimaryTypes وexcludedPrimaryTypes، سيتم عرض خطأ ضياء_أمل. إذا تم تحديد نوع مكان مع قيود من الأنواع المتعددة، فلن يتم عرض سوى الأماكن التي تفي بجميع القيود. على سبيل المثال، إذا كان لدينا {includedTypes = ["Restaurant"],excludedTypes = ["Restaurant"]}، ستوفّر الأماكن التي تم إرجاعها كلمة "مطعم". خدمات ذات صلة ولكنّها لا تعمل في المقام الأول "كمطاعم". |
maxResultCount |
الحد الأقصى لعدد النتائج المطلوب عرضها. يجب أن تتراوح القيمة بين 1 و20 (القيمة التلقائية)، بشكل شامل. وفي حال ترك الرقم بدون ضبط، سيتم الرجوع إلى الحدّ الأقصى. إذا تم ضبط الرقم على سالب أو تجاوز الحد الأقصى، سيتم عرض خطأ Connected_ التحكّم. |
locationRestriction |
مطلوب. المنطقة التي تريد البحث فيها. |
rankPreference |
كيفية ترتيب النتائج في الرد |
نص الاستجابة
نموذج الاستجابة للبحث عن الأجهزة المجاورة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"places": [
{
object ( |
الحقول | |
---|---|
places[] |
قائمة بالأماكن التي تستوفي متطلبات المستخدم، مثل أنواع الأماكن وعدد الأماكن والقيود المحدّدة على الموقع الجغرافي |
LocationRestriction
المنطقة التي تريد البحث فيها.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد يمكن أن يكون |
|
circle |
دائرة محددة بنقطة المركز ونصف القطر. |
RankPreference
كيفية ترتيب النتائج في الرد
عمليات التعداد | |
---|---|
RANK_PREFERENCE_UNSPECIFIED |
لم يتم ضبط قيمة RankPreference. سيتم استخدام "الترتيب حسب "POPULARITY" بشكلٍ تلقائي. |
DISTANCE |
لترتيب النتائج حسب المسافة. |
POPULARITY |
لترتيب النتائج حسب مدى رواجها. |