تتيح Places API ميزة البحث عن الأماكن المجاورة الحالية. إذا كنت على دراية بميزة "البحث عن الأماكن القريبة" الحالية، يُجري الإصدار الجديد من ميزة "البحث عن الأماكن القريبة" التغييرات التالية:
- يستخدم أسلوب "البحث عن الأماكن القريبة" الجديد طلبات POST لبروتوكول HTTP. تمرير المَعلمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST في المقابل، في ميزة "البحث عن الأجهزة المجاورة" الحالية، يتم تمرير مَعلمات عناوين URL باستخدام طلب HTTP GET.
- يجب حجب الحقول. يجب تحديد الحقول التي تريد عرضها في الاستجابة. لا تتوفّر قائمة تلقائية بالحقول المعروضة. في حال حذف هذه القائمة، ستعرض الطرق خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- تتوافق ميزة "البحث عن الأماكن القريبة" الجديدة مع كلاً من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كميكانيكية للمصادقة.
- لا يُسمح إلا بتنسيق JSON كتنسيق استجابة في ميزة "البحث عن الأماكن القريبة" الجديدة.
- يجب الآن استخدام البحث النصي (جديد) في جميع الطلبات التي تتضمّن طلب بحث نصي، لأنّ ميزة "البحث في الأماكن القريبة (جديد)" لا تتيح إدخال نص.
- تغيّر تنسيق استجابة JSON لواجهة برمجة التطبيقات Nearby Search (New) API عن تنسيق واجهات برمجة التطبيقات الحالية. لمزيد من التفاصيل، يُرجى الاطّلاع على نقل استجابة Places API.
يعرض الجدول التالي المَعلمات في ميزة "بحث Google المجاور" الحالية التي تمت إعادة تسميتها أو تعديلها لاستخدامها في ميزة "بحث Google المجاور" الجديدة، أو المَعلمات التي لم يعُد بالإمكان استخدامها.
| المَعلمة الحالية | معلَمة جديدة | ملاحظات |
|---|---|---|
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