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

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

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