Places API (جدید) شامل APIهای زیر است:
این سند شامل نمای کلی این APIهای جدید است.
جزئیات مکان (جدید)
شناسه مکان به طور منحصر به فردی مکان را در پایگاه داده Google Places و در Google Maps شناسایی می کند. با شناسه مکان، میتوانید با درخواست جزئیات مکان (جدید) جزئیات مربوط به یک موسسه یا نقطه مورد علاقه خاص را درخواست کنید. درخواست جزئیات مکان (جدید) اطلاعات جامعی درباره مکان مشخص شده مانند آدرس کامل، شماره تلفن، رتبهبندی کاربر و نظرات آن را برمیگرداند.
راه های زیادی برای دریافت شناسه مکان وجود دارد. می توانید استفاده کنید:
- جستجوی متن (جدید)
- جستجوی نزدیک (جدید)
- API کدگذاری جغرافیایی
- Routes API
- Address Validation API
- محل تکمیل خودکار
عکس مکان (جدید)
API عکس مکان (جدید) به شما امکان می دهد با دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Google Places، محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. با استفاده از Place Photo (New) API، میتوانید به عکسها دسترسی داشته باشید و اندازه تصویر را به اندازه بهینه برنامه خود تغییر دهید.
همه درخواستها به API عکس مکان (جدید) باید شامل یک نام منبع عکس باشند که بهطور منحصربهفرد عکس مورد نظر را برای بازگشت مشخص میکند. می توانید نام منبع عکس را با استفاده از:
برای گنجاندن نام منبع عکس در پاسخ درخواست جزئیات مکان (جدید)، جستجوی متن (جدید)، یا جستجوی نزدیک (جدید)، مطمئن شوید که فیلد photos
را در ماسک فیلد درخواست وارد کردهاید.
جستجوی متن (جدید) و جستجوی نزدیک (جدید)
Places API شامل دو API جستجو است:
به شما امکان می دهد یک رشته متنی را مشخص کنید که در آن مکان را جستجو کنید. به عنوان مثال: "غذاهای گیاهی تند در سیدنی، استرالیا" یا "غذاهای دریایی خوب در نزدیکی پالو آلتو، کالیفرنیا".
میتوانید جستجو را با تعیین جزئیاتی مانند سطح قیمت، وضعیت فعلی افتتاحیه، رتبهبندیها یا انواع مکانهای خاص اصلاح کنید. همچنین می توانید تعیین کنید که نتایج را به یک مکان خاص سوگیری کند، یا جستجو را به یک مکان خاص محدود کنید.
به شما امکان می دهد منطقه ای را برای جستجو به همراه لیستی از انواع مکان ها مشخص کنید. منطقه را به عنوان دایره ای مشخص کنید که با مختصات طول و عرض جغرافیایی نقطه مرکزی و شعاع بر حسب متر تعریف می شود.
یک یا چند نوع مکان را مشخص کنید که ویژگی های مکان را مشخص می کند. به عنوان مثال، "
pizza_restaurant
" و "shopping_mall
" را برای جستجوی پیتزافروشی واقع در مرکز خرید در منطقه مشخص شده مشخص کنید.
تفاوت اصلی بین این دو جستجو این است که جستجوی متن (جدید) به شما امکان می دهد یک رشته جستجوی دلخواه را مشخص کنید در حالی که جستجوی نزدیک (جدید) به منطقه خاصی برای جستجو نیاز دارد.
تکمیل خودکار (جدید) و نشانه های جلسه
تکمیل خودکار (جدید) یک سرویس وب است که پیشبینیهای مکان و پیشبینیهای پرس و جو را در پاسخ به درخواست HTTP برمیگرداند. در درخواست، یک رشته جستجوی متن و مرزهای جغرافیایی که منطقه جستجو را کنترل می کند، مشخص کنید.
نشانههای جلسه رشتههای تولید شده توسط کاربر هستند که تماسهای تکمیل خودکار (جدید) را بهعنوان جلسه پیگیری میکنند. تکمیل خودکار (جدید) از نشانههای جلسه برای گروهبندی مراحل جستجو و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورتحساب استفاده میکند.
فیلدها، ویژگی ها و گزینه های دسترسی جدید
Places API (جدید) شامل فیلدها، ویژگیها و گزینههای دسترسپذیری جدید است تا اطلاعات بیشتری درباره یک مکان در اختیار کاربران قرار دهد. این جنبه ها در بخش های بعدی توضیح داده شده است.
فیلدها
Places API (جدید) شامل چندین فیلد جدید است:
میدان | توضیحات |
---|---|
regularSecondaryOpeningHours | زمان های خاصی را برای عملیات معین توصیف می کند. ساعات کار ثانویه با ساعات کاری اصلی یک کسب و کار متفاوت است. به عنوان مثال، یک رستوران می تواند ساعات رانندگی یا ساعت تحویل را به عنوان ساعات فرعی خود مشخص کند. |
paymentOptions | گزینه های پرداخت محل می پذیرد. یک مکان می تواند بیش از یک گزینه پرداخت را بپذیرد. اگر اطلاعات گزینه پرداخت در دسترس نباشد، قسمت گزینه پرداخت تنظیم نخواهد شد. گزینه ها شامل موارد زیر است:
|
parkingOptions | گزینه های پارکینگ ارائه شده توسط مکان. گزینه ها شامل موارد زیر است:
|
subDestinations | مکان های منحصر به فردی که مربوط به یک مکان خاص است. به عنوان مثال، پایانه های فرودگاه به عنوان مقاصد فرعی یک فرودگاه در نظر گرفته می شوند. |
fuelOptions | جدیدترین اطلاعات در مورد گزینه های سوخت موجود در پمپ بنزین. این اطلاعات به طور مرتب به روز می شود. گزینه ها شامل موارد زیر است:
|
evChargeOptions | تعداد شارژرهای خودروی الکتریکی (EV) در این ایستگاه. در حالی که برخی از شارژرهای EV چند کانکتور دارند، هر شارژر فقط می تواند یک وسیله نقلیه را در یک زمان شارژ کند. در نتیجه، این فیلد تعداد شارژرهای EV موجود در یک زمان معین را نشان می دهد. |
shortFormattedAddress | آدرسی کوتاه و قابل خواندن برای یک مکان برای انسان. |
primaryType | نوع اولیه نتیجه داده شده. به عنوان مثال، یک مکان ممکن است به عنوان یک cafe یا یک airport طبقه بندی شود. یک مکان فقط می تواند یک نوع اولیه داشته باشد. برای فهرست کامل مقادیر ممکن، انواع پشتیبانی شده را ببینید. |
primaryTypeDisplayName | نام نمایشی نوع اصلی که در صورت وجود به زبان درخواست ترجمه شده است. برای فهرست کامل مقادیر ممکن، انواع پشتیبانی شده را ببینید. |
صفات
Places API (جدید) شامل چندین ویژگی جدید است:
صفت | توضیحات |
---|---|
outdoorSeating | مکان صندلی در فضای باز فراهم می کند. |
liveMusic | مکان موسیقی زنده را ارائه می دهد. |
menuForChildren | مکان دارای منوی کودکان است. |
servesCocktails | محل سرو کوکتل است. |
servesDessert | محل سرو دسر. |
servesCoffee | محل سرو قهوه است. |
goodForChildren | مکان برای کودکان خوب است. |
allowsDogs | مکان به سگ ها اجازه می دهد. |
restroom | محل دارای سرویس بهداشتی است. |
goodForGroups | مکان گروه ها را در خود جای می دهد. |
goodForWatchingSports | مکانی برای تماشای ورزش مناسب است. |
گزینه های دسترسی
Places API (جدید) شامل فیلدهای گزینه دسترسی زیر است:
میدان | توضیحات |
---|---|
wheelchairAccessibleParking | مکان دارای پارکینگ قابل دسترسی برای ویلچر است. |
wheelchairAccessibleEntrance | این مکان دارای ورودی قابل دسترسی برای ویلچر است. |
wheelchairAccessibleRestroom | این مکان دارای سرویس بهداشتی قابل دسترسی برای ویلچر است. |
wheelchairAccessibleSeating | مکان دارای صندلی های قابل دسترسی برای ویلچر است. |
به API های مکان های جدید مهاجرت کنید
اگر مشتری فعلی Places API هستید و میخواهید برنامه خود را برای استفاده از APIهای جدید منتقل کنید، به مستندات انتقال زیر مراجعه کنید: