تتيح Places API استخدام البحث النصي الحالي. إذا كنت معتادًا على البحث النصي الحالي، يُجري الإصدار الجديد من البحث النصي التغييرات التالية:
- يستخدم البحث النصي الجديد طلبات HTTP POST. تمرير المعلَمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST وفي المقابل، باستخدام ميزة "البحث النصي" الحالية، يمكنك تمرير معلَمات عناوين URL باستخدام طلب HTTP GET.
- يجب إخفاء الحقول. يجب تحديد الحقول التي تريد عرضها في الرد. لا تتوفّر قائمة تلقائية للحقول المعروضة. وإذا حذفت هذه القائمة، ستعرض الطرق خطأً. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- يتيح الإصدار الجديد من "البحث النصي" استخدام كلّ من مفاتيح واجهة برمجة التطبيقات والرموز المميّزة OAuth كآلية للمصادقة.
- يمكن استخدام تنسيق JSON فقط كتنسيق للاستجابة في ميزة "البحث النصي" الجديدة.
يتيح لك البحث النصي الحالي تحديد إحداثيات خطي الطول والعرض في سلسلة طلب البحث. مثلاً:
query=37.4239,-122.0925هذا الخيار غير متاح في البحث النصي الجديد.استخدِم الترميز الجغرافي العكسي للبحث عن الإحداثيات وعرض عنوان، أو استخدِم البحث عن قرب (جديد) للعثور على أماكن حول موقع جغرافي محدّد.
- تم تغيير تنسيق استجابة JSON لواجهة برمجة التطبيقات Text Search (New) من تنسيق واجهات برمجة التطبيقات الحالية. لمزيد من التفاصيل، يمكنك الاطّلاع على نقل الردّ على Places API.
يسرد الجدول التالي المعلَمات في "البحث النصي" الحالي التي تمت إعادة تسميتها أو تعديلها للبحث النصي الجديد، أو المعلَمات التي لم تعُد متوافقة.
| المَعلمة الحالية | معلَمة جديدة | Notes |
|---|---|---|
evOptions |
مَعلمة جديدة. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
غير متاح. | |
query |
textQuery |
مطلوبة في جميع الطلبات. |
radius |
locationBias |
حدِّد النطاق الجغرافي عند تحديد locationBias. |
region |
regionCode |
|
type |
includedType |
يأخذ قيمة واحدة فقط. |
strictTypeFiltering |
مَعلمة جديدة. |
مثال على الطلب
يستخدم المثال التالي طلب GET البحث النصي الموجود. في هذا المثال، ستطلب استجابة JSON يحتوي على معلومات حول "الطعام النباتي الحار في سيدني بأستراليا" وتمرير جميع المعلمات كمعلَمات عناوين URL:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/textsearch/json?query=Spicy%20Vegetarian%20Food%20in%20Sydney%20Australia&key=API_KEY
باستخدام البحث النصي (جديد)، يمكنك تقديم طلب POST وتمرير جميع المعلمات في نص طلب JSON أو في العناوين كجزء من طلب POST. يستخدم هذا المثال أيضًا قناع حقل بحيث يتضمن الرد فقط الاسم المعروض والعنوان المنسَّق للمكان:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-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:searchText'