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