مقدمه
Places API از جزئیات جا (قدیمی) پشتیبانی میکند. اگر با Places API (قدیمی) آشنایی دارید، جزئیات جا (جدید) تغییرات زیر را ایجاد میکند:
- پوشش فیلد الزامی است. باید مشخص کنید که میخواهید کدام فیلدها در پاسخ برگردانده شود. فهرست پیشفرضی برای فیلدهای برگرداندهشده وجود ندارد. اگر این فهرست را حذف کنید، روشها خطا برمیگردانند. برای اطلاعات بیشتر، به FieldMask مراجعه کنید.
- «جزئیات مکان» (جدید) از هر دو کلید میانای برنامهسازی کاربردی و کد OAuth بهعنوان سازوکار اصالتسنجی پشتیبانی میکند.
- فقط JSON بهعنوان قالب پاسخ در «جزئیات مکان (جدید)» پشتیبانی میشود.
- قالب پاسخ JSON برای Places API (جدید) نسبتبه قالب میاناهای برنامهسازی کاربردی قدیمی تغییر کرده است. برای جزئیات بیشتر، انتقال پاسخ Places API را ببینید.
جدول زیر پارامترهای موجود در «جزئیات مکان (قدیمی)» را فهرست میکند که برای «جزئیات مکان (جدید)» تغییر نام داده یا اصلاح شدهاند، یا پارامترهایی که دیگر پشتیبانی نمیشوند.
| پارامتر فعلی | پارامتر جدید | یادداشتها |
|---|---|---|
place_id |
places/PLACE_ID |
رشته places/PLACE_ID
نام منبع مکان نیز نامیده میشود. در پاسخ از درخواست «جزئیات مکان (جدید)»، «جستجوی اطراف (جدید)»، و «جستجوی نوشتار (جدید)»، این رشته در فیلد name پاسخ قرار دارد.
شناسه مکان مستقل در فیلد id پاسخ قرار دارد. |
language |
languageCode |
|
region |
regionCode |
درخواست نمونه
درخواست GET نمونه زیر از «جزئیات جا» (قدیمی) استفاده میکند. در این
مثال، شما درخواست پاسخ JSON حاوی اطلاعات مربوط به شناسه مکان را میدهید و
همه پارامترها را بهعنوان پارامترهای URL ارسال میکنید. این مثال همچنین از fields استفاده میکند، بنابراین
پاسخ فقط شامل نام نمایشی و نشانی قالببندیشده مکان است:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
با «جزئیات مکان (جدید)»، درخواست GET میدهید و همه پارامترها را در پارامترها و سرایندهای نشانی وب بهعنوان بخشی از درخواست ارسال میکنید. این مثال همچنین از ماسک فیلد استفاده میکند تا پاسخ فقط شامل نام نمایشی و نشانی قالببندیشده مکان باشد:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
رشته places/PLACE_ID را
نام منبع مکان نیز مینامند. در پاسخ از درخواست «جزئیات مکان (جدید)»،
«جستجوی اطراف (جدید)»، و «جستجوی نوشتار (جدید)»، این رشته
در فیلد name پاسخ قرار دارد. شناسه مکان مستقل در فیلد id پاسخ قرار دارد.