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