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