نقل البيانات إلى ميزة "البحث عن قرب" (ميزة جديدة)

تتيح 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 includedTypes
excludedTypes
includedPrimaryTypes
excludedPrimaryTypes
تقبل المعلمات الجديدة أيضًا قيم أنواع متعددة. واجهة برمجة التطبيقات الحالية وتقبل قيمة واحدة فقط.

مثال على الطلب

يستخدم المثال التالي طلب 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