مقدمة
تتيح 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'