Places API از جزئیات مکان (میراث) پشتیبانی می کند. اگر با Places API (Legacy) آشنا هستید، Place Details (جدید) تغییرات زیر را ایجاد می کند:
- پوشاندن میدان مورد نیاز است. شما باید مشخص کنید که کدام فیلدها را می خواهید در پاسخ بازگردانید. هیچ لیست پیش فرضی از فیلدهای برگشتی وجود ندارد. اگر این لیست را حذف کنید، متدها با خطا مواجه می شوند. برای اطلاعات بیشتر، FieldMask را ببینید.
- Place Details جدید از کلیدهای API و نشانه‌های OAuth به عنوان مکانیزم احراز هویت پشتیبانی می‌کند.
- فقط JSON به عنوان قالب پاسخ در جزئیات مکان جدید پشتیبانی می شود.
- قالب پاسخ JSON برای API جزئیات مکان (جدید) از قالب APIهای قدیمی تغییر کرده است. برای جزئیات بیشتر، به انتقال پاسخ API Places مراجعه کنید.
جدول زیر پارامترهایی را در جزئیات مکان (میراث) که برای جزئیات مکان (جدید) تغییر نام داده یا تغییر یافته اند، یا پارامترهایی که دیگر پشتیبانی نمی شوند، فهرست می کند.
| پارامتر فعلی | پارامتر جدید | یادداشت ها |
|---|---|---|
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 می کنید و تمام پارامترها را در پارامترهای URL و هدرها به عنوان بخشی از درخواست ارسال می کنید. این مثال همچنین از یک فیلد ماسک استفاده می کند، بنابراین پاسخ فقط شامل نام نمایشی و آدرس فرمت شده مکان است:
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 پاسخ موجود است.