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

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

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