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