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