درباره Places API (جدید)

Places API (جدید) شامل APIهای زیر است:

این سند شامل نمای کلی این APIهای جدید است.

جزئیات مکان (جدید)

شناسه مکان به طور منحصر به فردی مکان را در پایگاه داده Google Places و در Google Maps شناسایی می کند. با شناسه مکان، می‌توانید با درخواست جزئیات مکان (جدید) جزئیات مربوط به یک موسسه یا نقطه مورد علاقه خاص را درخواست کنید. درخواست جزئیات مکان (جدید) اطلاعات جامعی درباره مکان مشخص شده مانند آدرس کامل، شماره تلفن، رتبه‌بندی کاربر و نظرات آن را برمی‌گرداند.

راه های زیادی برای دریافت شناسه مکان وجود دارد. می توانید استفاده کنید:

عکس مکان (جدید)

API عکس مکان (جدید) به شما امکان می دهد با دسترسی به میلیون ها عکس ذخیره شده در پایگاه داده Google Places، محتوای عکاسی با کیفیت بالا را به برنامه خود اضافه کنید. با استفاده از Place Photo (New) API، می‌توانید به عکس‌ها دسترسی داشته باشید و اندازه تصویر را به اندازه بهینه برنامه خود تغییر دهید.

همه درخواست‌ها به API عکس مکان (جدید) باید شامل یک نام منبع عکس باشند که به‌طور منحصربه‌فرد عکس مورد نظر را برای بازگشت مشخص می‌کند. می توانید نام منبع عکس را با استفاده از:

برای گنجاندن نام منبع عکس در پاسخ درخواست جزئیات مکان (جدید)، جستجوی متن (جدید)، یا جستجوی نزدیک (جدید)، مطمئن شوید که فیلد photos را در ماسک فیلد درخواست وارد کرده‌اید.

جستجوی متن (جدید) و جستجوی نزدیک (جدید)

Places API شامل دو API جستجو است:

  • جستجوی متن (جدید)

    به شما امکان می دهد یک رشته متنی را مشخص کنید که در آن مکان را جستجو کنید. به عنوان مثال: "غذاهای گیاهی تند در سیدنی، استرالیا" یا "غذاهای دریایی خوب در نزدیکی پالو آلتو، کالیفرنیا".

    می‌توانید جستجو را با تعیین جزئیاتی مانند سطح قیمت، وضعیت فعلی افتتاحیه، رتبه‌بندی‌ها یا انواع مکان‌های خاص اصلاح کنید. همچنین می توانید تعیین کنید که نتایج را به یک مکان خاص سوگیری کند، یا جستجو را به یک مکان خاص محدود کنید.

  • جستجوی نزدیک (جدید)

    به شما امکان می دهد منطقه ای را برای جستجو به همراه لیستی از انواع مکان ها مشخص کنید. منطقه را به عنوان دایره ای مشخص کنید که با مختصات طول و عرض جغرافیایی نقطه مرکزی و شعاع بر حسب متر تعریف می شود.

    یک یا چند نوع مکان را مشخص کنید که ویژگی های مکان را مشخص می کند. به عنوان مثال، " pizza_restaurant " و " shopping_mall " را برای جستجوی پیتزافروشی واقع در مرکز خرید در منطقه مشخص شده مشخص کنید.

تفاوت اصلی بین این دو جستجو این است که جستجوی متن (جدید) به شما امکان می دهد یک رشته جستجوی دلخواه را مشخص کنید در حالی که جستجوی نزدیک (جدید) به منطقه خاصی برای جستجو نیاز دارد.

تکمیل خودکار (جدید) و نشانه های جلسه

تکمیل خودکار (جدید) یک سرویس وب است که پیش‌بینی‌های مکان و پیش‌بینی‌های پرس و جو را در پاسخ به درخواست HTTP برمی‌گرداند. در درخواست، یک رشته جستجوی متن و مرزهای جغرافیایی که منطقه جستجو را کنترل می کند، مشخص کنید.

نشانه‌های جلسه رشته‌های تولید شده توسط کاربر هستند که تماس‌های تکمیل خودکار (جدید) را به‌عنوان جلسه پیگیری می‌کنند. تکمیل خودکار (جدید) از نشانه‌های جلسه برای گروه‌بندی مراحل جستجو و انتخاب جستجوی تکمیل خودکار کاربر در یک جلسه مجزا برای اهداف صورت‌حساب استفاده می‌کند.

فیلدها، ویژگی ها و گزینه های دسترسی جدید

Places API (جدید) شامل فیلدها، ویژگی‌ها و گزینه‌های دسترس‌پذیری جدید است تا اطلاعات بیشتری درباره یک مکان در اختیار کاربران قرار دهد. این جنبه ها در بخش های بعدی توضیح داده شده است.

فیلدها

Places API (جدید) شامل چندین فیلد جدید است:

میدان توضیحات
regularSecondaryOpeningHours زمان های خاصی را برای عملیات معین توصیف می کند. ساعات کار ثانویه با ساعات کاری اصلی یک کسب و کار متفاوت است. به عنوان مثال، یک رستوران می تواند ساعات رانندگی یا ساعت تحویل را به عنوان ساعات فرعی خود مشخص کند.
paymentOptions گزینه های پرداخت محل می پذیرد. یک مکان می تواند بیش از یک گزینه پرداخت را بپذیرد. اگر اطلاعات گزینه پرداخت در دسترس نباشد، قسمت گزینه پرداخت تنظیم نخواهد شد. گزینه ها شامل موارد زیر است:
  • کارت اعتباری
  • کارت بدهی
  • فقط نقدی
  • پرداخت NFC
parkingOptions گزینه های پارکینگ ارائه شده توسط مکان. گزینه ها شامل موارد زیر است:
  • پارکینگ های رایگان
  • پارکینگ های پولی
  • پارکینگ خیابانی رایگان
  • پارکینگ خدمتکار
  • پارکینگ گاراژ رایگان
  • پارکینگ گاراژ پولی
subDestinations مکان های منحصر به فردی که مربوط به یک مکان خاص است. به عنوان مثال، پایانه های فرودگاه به عنوان مقاصد فرعی یک فرودگاه در نظر گرفته می شوند.
fuelOptions جدیدترین اطلاعات در مورد گزینه های سوخت موجود در پمپ بنزین. این اطلاعات به طور منظم به روز می شود. گزینه ها شامل موارد زیر است:
  • دیزل
  • بدون سرب معمولی
  • متوسطه
  • حق بیمه
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • LPG
  • E80
  • E85
  • متان
  • بیودیزل
  • دیزل کامیون
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های جدید منتقل کنید، به مستندات انتقال زیر مراجعه کنید: