تتيح Places API الحالية البحث النصي. إذا كنت على دراية بالأسلوب الحالي البحث النصي، الإصدار الجديد من البحث النصي بإجراء التغييرات التالية:
- يستخدم البحث النصي الجديد طلبات HTTP POST. تم اجتياز الاختبار المعلَمات في نص الطلب أو العناوين كجزء من طلب HTTP POST. وعلى النقيض من ذلك، باستخدام البحث النصي الحالي، فإنك تجتاز معلمات عناوين URL تستخدم طلب HTTP GET.
- يجب إخفاء الحقل. يجب تحديد الحقول التي تريد عرضها. في الرد. لا تتوفّر قائمة تلقائية للحقول التي تم إرجاعها. في حال حذف بطاقة هذه القائمة، فستُرجع الطرق خطأ. لمزيد من المعلومات، يُرجى مراجعة FieldMask:
- يتوافق "البحث النصي" الجديد مع مفتاحَي واجهة برمجة التطبيقات. ورموز OAuth كآلية للمصادقة.
- يمكن استخدام JSON فقط كتنسيق استجابة في الإصدار الجديد البحث النصي.
يتيح لك البحث النصي الحالي تحديد خطوط الطول والعرض في سلسلة الاستعلام. مثلاً:
query=37.4239,-122.0925هذا الخيار غير متاح في البحث النصي الجديد.استخدام الترميز الجغرافي العكسي للبحث عن الإحداثيات وعرض عنوان، أو البحث عن قرب (جديد) للعثور على أماكن حول موقع جغرافي معيّن.
- تنسيق استجابة JSON للبحث النصي (جديد) تم تغيير تنسيق واجهات برمجة التطبيقات (API) الحالية. لمزيد من التفاصيل، يُرجى مراجعة نقل رد Places API
يسرد الجدول التالي المعلَمات في الجدول الزمني الحالي البحث النصي الذي تمت إعادة تسميته أو تعديله للملف أو البحث النصي الجديد، أو المعلمات التي لم تعد
| المعلمة الحالية | معلَمة جديدة | ملاحظات |
|---|---|---|
evOptions |
مَعلمة جديدة. | |
language |
languageCode |
|
location |
locationBias |
|
maxprice/minprice |
priceLevels |
|
opennow |
openNow |
|
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'