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