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

المطوّرون في المنطقة الاقتصادية الأوروبية

مقدمة

تتيح واجهة برمجة التطبيقات Places API استخدام "البحث في الجوار" (الإصدار القديم). إذا كنت على دراية بخدمة "البحث في الجوار" (الإصدار القديم)، فإنّ خدمة البحث في الجوار (الإصدار الجديد) تُجري التغييرات التالية:

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

باستخدام واجهة برمجة التطبيقات بحث في الجوار (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