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

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

مقدمة

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

  • تستخدم خدمة "بحث في الجوار" (الجديدة) طلبات HTTP POST. مرِّر المَعلمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST. في المقابل، عند استخدام بحث في الجوار (الإصدار القديم)، يمكنك تمرير مَعلمات عنوان 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'

باستخدام ميزة "بحث في الجوار" (الجديدة)، يمكنك إرسال طلب 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