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

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

مقدمة

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

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