تتيح Places API استخدام ميزة البحث عن الأجهزة المجاورة الحالية. إذا كنت معتادًا على استخدام ميزة البحث عن الأجهزة الحالية، فإن الإصدار الجديد من ميزة البحث عن قرب سيجري التغييرات التالية:
- يستخدم البحث عن قرب الجديد طلبات HTTP POST. أدخِل المعلَمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST. وعلى النقيض من خيار "البحث عن قرب" الحالي، يمكنك تمرير معلَمات عناوين URL باستخدام طلب HTTP GET.
- يجب إخفاء الحقل. عليك تحديد الحقول التي تريد عرضها في الردّ. لا تتوفّر قائمة تلقائية للحقول التي تم إرجاعها. إذا لم تستخدم هذه القائمة، ستعرض الطرق رسالة خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- تتوافق ميزة "البحث عن قرب" الجديدة مع كل من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كآلية للمصادقة.
- يمكن استخدام JSON فقط كتنسيق استجابة في ميزة "البحث عن قرب" الجديد.
- يجب أن تستخدم الآن جميع الطلبات التي تتضمّن طلب بحث نصي البحث النصي (جديد) لأنّ ميزة "البحث عن قرب" (جديد) لا تتيح إدخال النص.
- تم تغيير تنسيق استجابة JSON لواجهة برمجة التطبيقات للبحث عن قرب (جديد) من تنسيق واجهات برمجة التطبيقات الحالية. لمزيد من التفاصيل، يُرجى الاطّلاع على نقل استجابة واجهة برمجة التطبيقات للأماكن.
يسرد الجدول التالي المعلمات في "البحث عن الأجهزة المجاورة" الحالي التي تمت إعادة تسميتها أو تعديلها للبحث عن قرب الجديد، أو المعلمات التي لم تعد متوافقة.
| المعلمة الحالية | معلَمة جديدة | Notes |
|---|---|---|
keyword |
غير متاح. استخدِم البحث النصي (جديد) بدلاً من ذلك. | |
language |
languageCode |
|
location |
locationRestriction |
مطلوبة. |
maxprice/minprice |
|
غير متاح. |
maxResultCount |
مَعلمة جديدة. | |
opennow |
|
غير متاح. |
pagetoken |
غير متاح. | |
radius |
|
استخدِم "locationRestriction" الآن. |
rankby |
rankPreference |
|
regionCode |
مَعلمة جديدة. | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
تقبل المعلمات الجديدة أيضًا قيم أنواع متعددة. ولا تقبل واجهة برمجة التطبيقات الحالية سوى قيمة واحدة. |
مثال على الطلب
يستخدم المثال التالي طلب GET ميزة "البحث عن الأجهزة المجاورة" الحالية. في هذا المثال، تطلب استجابة JSON
تحتوي على معلومات عن الأماكن من النوع restaurant وتمرِّر جميع
المَعلمات كمَعلمات عناوين URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=37.7937%2C-122.3965&radius=500&type=restaurant&key=API_KEY'
تتيح لك ميزة "البحث عن قرب" (New) إجراء طلب POST وتمرير جميع المعلَمات في نص طلب JSON أو في العناوين كجزء من طلب POST. يستخدم هذا المثال أيضًا قناع حقل بحيث لا يتضمن الرد سوى الاسم المعروض والعنوان المنسّق للمكان:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"locationRestriction": {
"circle": {
"center": {
"latitude": 37.7937,
"longitude": -122.3965},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.displayName,places.formattedAddress" \
https://places.googleapis.com/v1/places:searchNearby