تتيح Places API استخدام ميزة البحث النصي الحالية. إذا كنت على دراية بميزة البحث النصي الحالية، يُجري الإصدار الجديد من ميزة البحث النصي التغييرات التالية:
- تستخدِم ميزة "البحث النصي" الجديدة طلبات HTTP POST. نقْل المَعلمات في نص الطلب أو في العناوين كجزء من طلب HTTP POST في المقابل، باستخدام ميزة "البحث النصي" الحالية، يمكنك تمرير مَعلمات عناوين URL باستخدام طلب HTTP GET.
- يجب استخدام ميزة إخفاء الحقول. يجب تحديد الحقول التي تريد عرضها في الاستجابة. لا تتوفّر قائمة تلقائية بالحقول المعروضة. في حال حذف هذه القائمة، ستعرض الطُرق خطأ. لمزيد من المعلومات، يُرجى الاطّلاع على FieldMask.
- تتيح ميزة "البحث النصي" الجديدة استخدام كلّ من مفاتيح واجهة برمجة التطبيقات ورموز OAuth كميكانيكية للمصادقة.
- لا يتوفّر سوى تنسيق JSON كتنسيق استجابة في ميزة البحث النصي الجديدة.
تتيح لك ميزة "البحث النصي" الحالية تحديد إحداثيات خط الطول وخط العرض في سلسلة طلب البحث. على سبيل المثال:
query=37.4239,-122.0925. هذا الخيار غير متاح في ميزة "البحث النصي" الجديدة.استخدِم الترميز الجغرافي العكسي للبحث عن عناوين باستخدام الإحداثيات، أو البحث عن الأماكن المجاورة (ميزة جديدة) للعثور على أماكن حول موقع جغرافي معيّن.
- تغيّر تنسيق ردّ JSON لواجهة برمجة التطبيقات Text Search (New) ، وأصبح مختلفًا عن تنسيق واجهات برمجة التطبيقات الحالية. لمزيد من التفاصيل، يُرجى الاطّلاع على نقل استجابة Places API.
يسرد الجدول التالي المَعلمات في "البحث النصي" الحالي التي تمت إعادة تسميتها أو تعديلها في "البحث النصي" الجديد، أو المَعلمات التي لم يعُد بالإمكان استخدامها.
| المَعلمة الحالية | معلَمة جديدة | ملاحظات |
|---|---|---|
evOptions |
مَعلمة جديدة. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
pagetoken |
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'