مقدمه
Places API از جزئیات مکان (قدیمی) پشتیبانی می‌کند. اگر با Places API (قدیمی) آشنایی دارید، جزئیات مکان (جدید) تغییرات زیر را ایجاد می‌کند:
- پوشش فیلد الزامی است. باید مشخص کنید که کدام فیلدها را می‌خواهید در پاسخ برگردانده شود. هیچ فهرست پیش‌فرضی از فیلدهای برگردانده‌شده وجود ندارد. اگر این فهرست را حذف کنید، روش‌ها خطا برمی‌گردانند. برای اطلاعات بیشتر، به FieldMask مراجعه کنید.
- «جزئیات مکان» (جدید) از هر دو کلیدهای میانای برنامه‌سازی کاربردی و کدهای OAuth به‌عنوان سازوکار اصالت‌سنجی پشتیبانی می‌کند.
- فقط JSON به‌عنوان قالب پاسخ در «جزئیات مکان (جدید)» پشتیبانی می‌شود.
- قالب پاسخ JSON برای «میانای برنامه‌سازی کاربردی Places» (جدید) از قالب میاناهای برنامه‌سازی کاربردی قدیمی تغییر کرده است. برای جزئیات بیشتر، انتقال پاسخ Places API را ببینید.
جدول زیر پارامترهای موجود در «جزئیات مکان (قدیمی)» را فهرست می‌کند که برای «جزئیات مکان (جدید)» تغییر نام داده یا اصلاح شده‌اند، یا پارامترهایی که دیگر پشتیبانی نمی‌شوند.
| پارامتر فعلی | پارامتر جدید | یادداشت‌ها |
|---|---|---|
place_id |
places/PLACE_ID |
رشته places/PLACE_ID
نام منبع مکان نیز نامیده می‌شود. در پاسخ درخواست «جزئیات مکان (جدید)»،
«جستجوی اطراف (جدید)»، و «جستجوی نوشتاری (جدید)»،
این رشته در فیلد name پاسخ قرار دارد.
شناسه مکان مستقل در فیلد id پاسخ قرار دارد. |
language |
languageCode |
|
region |
regionCode |
درخواست نمونه
درخواست GET زیر از «جزئیات مکان» (قدیمی) استفاده می‌کند. در این
مثال، درخواست پاسخ JSON حاوی اطلاعات درباره شناسه مکان می‌کنید و
همه پارامترها را به‌عنوان پارامترهای نشانی وب ارسال می‌کنید. این مثال همچنین از 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 پاسخ قرار دارد.