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