تتيح Places API استخدام ميزة البحث عن الأجهزة المجاورة الحالية. إذا كنت على دراية بميزة "البحث عن الأماكن القريبة" الحالية، يُجري الإصدار الجديد من ميزة "البحث عن الأماكن القريبة" التغييرات التالية:
- يستخدم أسلوب "البحث عن الأماكن القريبة" الجديد طلبات POST لبروتوكول HTTP. تمرير المَعلمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST وعلى عكس ميزة "البحث عن قرب" الحالية، يمكنك تمرير معلَمات عناوين URL باستخدام طلب HTTP GET.
- يجب إخفاء الحقل. يجب تحديد الحقول التي تريد عرضها في الاستجابة. لا تتوفّر قائمة تلقائية للحقول التي تم إرجاعها. إذا لم تستخدم هذه القائمة، ستعرض الطرق رسالة خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- تتوافق ميزة "البحث عن الأماكن القريبة" الجديدة مع كل من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كميكانيكية للمصادقة.
- لا يُسمح إلا بتنسيق JSON كتنسيق استجابة في ميزة "البحث عن الأماكن القريبة" الجديدة.
- يجب الآن استخدام البحث النصي (جديد) في جميع الطلبات التي تتضمّن طلب بحث نصي، لأنّ ميزة "البحث في الأماكن القريبة (جديد)" لا تتيح إدخال نص.
- تغيّر تنسيق استجابة JSON لواجهة برمجة التطبيقات Nearby Search (New) API عن تنسيق واجهات برمجة التطبيقات الحالية. لمزيد من التفاصيل، يُرجى الاطّلاع على نقل استجابة Places API.
يعرض الجدول التالي المَعلمات في ميزة "بحث بالقرب منك" الحالية التي تمت إعادة تسميتها أو تعديلها لاستخدامها في ميزة "بحث بالقرب منك" الجديدة، أو المَعلمات التي لم يعُد بالإمكان استخدامها.
| المَعلمة الحالية | معلَمة جديدة | ملاحظات |
|---|---|---|
keyword |
غير مدعوم. استخدِم البحث عن نص (جديد) بدلاً من ذلك. | |
language |
languageCode |
|
location |
locationRestriction |
مطلوب. |
maxprice/minprice |
|
غير مدعوم. |
maxResultCount |
مَعلمة جديدة | |
opennow |
|
غير مدعوم. |
pagetoken |
غير مدعوم. | |
radius |
|
استخدِم locationRestriction الآن. |
rankby |
rankPreference |
|
regionCode |
مَعلمة جديدة | |
type |
includedTypesexcludedTypesincludedPrimaryTypesexcludedPrimaryTypes
|
تقبل المَعلمات الجديدة أيضًا قيم أنواع متعدّدة. لا تقبل واجهة برمجة التطبيقات الحالية سوى قيمة واحدة. |
مثال على الطلب
يستخدم المثال التالي طلب GET ميزة "البحث عن الأجهزة المجاورة" الحالية. في هذا المثال، تطلب restaurantاستجابة بتنسيق JSON تحتوي على معلومات عن الأماكن من النوع restaurant وتُمرِّر جميع 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'
باستخدام ميزة "البحث عن الأماكن القريبة" (الإصدار الجديد)، يمكنك إرسال طلب 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