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

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

مقدمة

تتيح Places API استخدام Nearby Search (الإصدار القديم). إذا كنت معتادًا على ميزة "البحث القريب" (الإصدار القديم)، ستلاحظ أنّ البحث القريب (الإصدار الجديد) يتضمّن التغييرات التالية:

  • يستخدم البحث القريب (الجديد) طلبات HTTP POST. قم بتمرير المعلمات في نص الطلب أو في الرؤوس كجزء من طلب HTTP POST. على النقيض من ذلك، باستخدام ميزة البحث القريب (Legacy)، يمكنك تمرير معلمات URL باستخدام طلب HTTP GET.
  • يجب إخفاء الحقل. يجب تحديد الحقول التي تريد عرضها في الرد. لا توجد قائمة تلقائية بالحقول التي يتم عرضها. إذا حذفت هذه القائمة، ستعرض الطرق خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
  • يدعم البحث القريب (جديد) كلاً من مفاتيح API ورموز OAuth كآلية مصادقة.
  • يتم دعم JSON فقط كتنسيق استجابة في البحث القريب (جديد).
  • يجب أن تستخدم جميع الطلبات التي تتضمّن طلب بحث نصيًا الآن الاستعلام عن نص (جديد) لأنّ ميزة "البحث في الأماكن القريبة (جديد)" لا تتيح إدخال نص.
  • تغيّر تنسيق استجابة JSON الخاص بخدمة Nearby Search (إصدار جديد) عن تنسيق واجهات برمجة التطبيقات القديمة. لمزيد من التفاصيل، يُرجى الاطّلاع على نقل استجابة Places API.

يسرد الجدول التالي المَعلمات في Nearby Search (الإصدار القديم) التي تمت إعادة تسميتها أو تعديلها في Nearby Search (الإصدار الجديد)، أو المَعلمات التي لم تعُد متاحة.

المَعلمة الحالية معلَمة جديدة ملاحظات
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