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