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