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

مقدمة

تتوافق Places API مع Nearby Search (الإصدار القديم). إذا كنت على دراية بـ Nearby Search (الإصدار القديم)، يُجري Nearby Search (الإصدار الجديد) التغييرات التالية:

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

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

المعلَمة الحالية	المعلَمة الجديدة	ملاحظات
keyword		غير متوافقة. استخدِم Text Search (الإصدار الجديد) بدلاً منها.
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'

باستخدام Nearby Search (الإصدار الجديد)، يمكنك إرسال طلب 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