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