تتيح Places API استخدام ميزة البحث النصي الحالية. إذا كنت على دراية بميزة البحث النصي الحالية، يُجري الإصدار الجديد من ميزة البحث النصي التغييرات التالية:
- يستخدم محرك البحث النصي الجديد طلبات POST لبروتوكول HTTP. نقْل المَعلمات في نص الطلب أو في العناوين كجزء من طلب 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'