این محصول یا ویژگی در وضعیت Legacy است و برای استفاده جدید قابل فعال نیست. برای اطلاعات بیشتر در مورد مرحله Legacy و نحوه انتقال از Legacy به سرویسهای جدیدتر، به
محصولات و ویژگیهای Legacy مراجعه کنید.، این محصول یا ویژگی در وضعیت Legacy است و برای استفاده جدید نمیتوان آن را فعال کرد. برای اطلاعات بیشتر درباره مرحله Legacy و نحوه انتقال از Legacy به سرویسهای جدیدتر، به
محصولات و ویژگیهای Legacy مراجعه کنید.
جستجوی مکان
Places API به شما امکان می دهد با استفاده از دسته بندی های مختلف، از جمله موسسات، نقاط دیدنی برجسته و مکان های جغرافیایی، اطلاعات مکان را جستجو کنید. شما می توانید مکان ها را از طریق نزدیکی یا یک رشته متن جستجو کنید. جستجوی مکان فهرستی از مکان ها را به همراه اطلاعات خلاصه در مورد هر مکان برمی گرداند. اطلاعات اضافی با استفاده از پرس و جو جزئیات مکان در دسترس است.
مقایسه انواع جستجو
سه نقطه پایانی جستجو با ویژگی های مختلف موجود است. جدول زیر برخی از این تفاوت ها را نشان می دهد.
انتخاب رشته
هیچ راهی برای محدود کردن جستجوی نزدیک یا جستجوی متنی برای بازگرداندن فیلدهای خاص وجود ندارد. برای جلوگیری از درخواست (و پرداخت برای) دادههایی که به آنها نیاز ندارید، به جای آن از درخواست Find Place استفاده کنید.
متن مبهم
Find Place و Text Search برای تطبیق متن مبهم در تعدادی از فیلدها بهینه شده اند، در حالی که Nearby Search محدود به مطابقت های دقیق در زیر مجموعه ای از فیلدها است.
فیلترهای اضافی
جستجوی نزدیک و جستجوی متن به پارامترهای اضافی اجازه میدهند تا نتایج را فیلتر کنند (به عنوان مثال minprice
، maxprice
، opennow
، و type
).
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-03-01 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-03-01 بهوقت ساعت هماهنگ جهانی."],[[["The Places API allows you to search for places using categories like establishments, points of interest, and geographic locations by proximity or text string."],["You can utilize the Places API with various platforms, including JavaScript, Web Service, and client libraries for server-side applications."],["For client-side development, consider the Places SDK for Android, iOS, and the Places Library for the Maps JavaScript API."],["Three search endpoints are available: Find Place, Nearby Search, and Text Search, each with unique characteristics like field selection and ambiguous text handling."],["Nearby Search and Text Search offer additional filters such as `minprice`, `maxprice`, `opennow`, and `type` to refine results."]]],["The Places API allows searching for places using categories, proximity, or text strings, returning a list with summary information. Three search endpoints are available: Find Place, Nearby Search, and Text Search. Find Place uses `input` and is best for specific field requests. Text Search uses `query` and Nearby Search uses `keyword`. Text Search and Find place are optimized for ambiguous text. Nearby search and text search can be filtered using parameters like `minprice` or `opennow`. The API is intended for server-side applications.\n"]]