جستجوی مکان
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA). Places API به شما امکان می دهد با استفاده از دسته بندی های مختلف، از جمله موسسات، نقاط دیدنی برجسته و مکان های جغرافیایی، اطلاعات مکان را جستجو کنید. شما می توانید مکان ها را از طریق نزدیکی یا یک رشته متن جستجو کنید. جستجوی مکان فهرستی از مکان ها را به همراه اطلاعات خلاصه در مورد هر مکان برمی گرداند. اطلاعات اضافی با استفاده از پرس و جو جزئیات مکان (میراث) در دسترس است.
مقایسه انواع جستجو
سه نقطه پایانی جستجو با ویژگی های مختلف موجود است. جدول زیر برخی از این تفاوت ها را نشان می دهد.
انتخاب رشته
هیچ راهی برای محدود کردن Nearby Search (Legacy) یا Text Search (Legacy) برای بازگرداندن فیلدهای خاص وجود ندارد. برای جلوگیری از درخواست (و پرداخت برای) داده‌هایی که به آن‌ها نیاز ندارید، به جای آن از درخواست Find Place (Legacy) استفاده کنید.
متن مبهم
Find Place (Legacy) و Text Search (Legacy) برای تطبیق متن مبهم در تعدادی از فیلدها بهینه شده اند در حالی که Nearby Search (Legacy) به تطابق دقیق در زیر مجموعه ای از فیلدها محدود شده است.
فیلترهای اضافی
Nearby Search (Legacy) و Text Search (Legacy) به پارامترهای اضافی اجازه می‌دهد تا نتایج را فیلتر کنند (مانند minprice ، maxprice ، opennow ، و type ).
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Place Search\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n**Note: Server-side\nand client-side libraries**\n\nThe Places API is also available with the\n[Java Client,\nPython Client, Go Client and Node.js Client for Google Maps Services](/maps/documentation/places/web-service/client-library).\nThe Places API and the client libraries are for\nuse in server applications.\n\nIf you're building a client-side\napplication, take a look at the\n[Places SDK for Android (New)](/maps/documentation/places/android-sdk), the\n[Places SDK for iOS (New)](/maps/documentation/places/ios-sdk), and the\n[Places Library, Maps JavaScript API](/maps/documentation/javascript/places).\n\nThe Places API lets you search for place information\nusing a variety of categories, including establishments, prominent points of\ninterest, and geographic locations. You can search for places either by\nproximity or a text string. A Place Search returns a list of places along with\nsummary information about each place; additional information is available using\na [Place Details (Legacy)](/maps/documentation/places/web-service/details) query.\n\nCompare search types\n--------------------\n\nThere are three search endpoints available with different characteristics. The following table\nhighlights some of these differences.\n\n| Type | [Field selection](#field-selection) | Text Search (Legacy) | [Ambiguous text](#ambiguous-text) | Location filter | [Additional filters](#additional-filters) |\n|----------------------------------------------------------------------------------------|-------------------------------------|----------------------|-----------------------------------|-----------------|-------------------------------------------|\n| [Find Place (Legacy)](/maps/documentation/places/web-service/legacy/search-find-place) | | `input` | | | |\n| [Nearby Search (Legacy)](/maps/documentation/places/web-service/legacy/search-nearby) | | `keyword` | | | |\n| [Text Search (Legacy)](/maps/documentation/places/web-service/legacy/search-text) | | `query` | | | |\n\n### Field selection\n\nThere is no way to constrain Nearby Search (Legacy) or Text Search (Legacy) to only return specific fields. To\nkeep from requesting (and paying for) data that you don't need, use a Find Place (Legacy) request instead.\n\n### Ambiguous text\n\nFind Place (Legacy) and Text Search (Legacy) are optimized for matching ambiguous text across a number of fields\nwhile Nearby Search (Legacy) is constrained to strict matches on a subset of fields.\n\n### Additional filters\n\nNearby Search (Legacy) and Text Search (Legacy) allow additional parameters to filter results,\n(e.g. `minprice`, `maxprice`, `opennow`, and `type`)."]]
