مقدمه
Places API (قدیمی) از جستجوی نوشتار (قدیمی) پشتیبانی میکند. اگر با «جستجوی نوشتار» (قدیمی) آشنا هستید، «جستجوی نوشتار» (جدید) تغییرات زیر را ایجاد میکند:
- «جستجوی نوشتار (جدید)» از درخواستهای HTTP POST استفاده میکند. پارامترها را در بدنه درخواست یا در سرصفحهها بهعنوان بخشی از درخواست HTTP POST ارسال کنید. درمقابل، با «جستجوی نوشتار (قدیمی)»، پارامترهای نشانی وب را بااستفاده از درخواست 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 حاوی اطلاعاتی درباره «غذای گیاهی تند در سیدنی، استرالیا» را درخواست میکنید و همه پارامترها را بهعنوان پارامترهای نشانی وب ارسال میکنید:
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'