Places API سرویسی است که درخواست های HTTP برای داده های مکان را از طریق روش های مختلف می پذیرد. داده‌های مکان قالب‌بندی شده و تصاویر مربوط به مؤسسات، مکان‌های جغرافیایی یا نقاط برجسته مورد علاقه را برمی‌گرداند.
چرا از Places API (جدید) استفاده کنید
ویژگی‌های آگاه از موقعیت مکانی را ایجاد کنید تا داده‌های موقعیت مکانی دقیق را در دسترس کاربران خود قرار دهید. داده‌های موجود از طریق Places API (جدید) بر اساس یکی از دقیق‌ترین، به‌روزترین و جامع‌ترین مدل‌های مکان در دنیای واقعی ساخته شده‌اند. در اینجا نمونه هایی از موارد استفاده برای برنامه ها آورده شده است:
کاندوهای اجاره‌ای در کلان‌شهرهای اصلی را با نتایجی که به‌طور خاص برای شهرها هدف‌گذاری شده است، نمایش دهید.
جزئیات مکان را در به‌روزرسانی وضعیت تحویل یا تحویل درج کنید.
نمایش لیستی از پارک ها در یک منطقه به همراه عکس ها و نظرات ارسال شده توسط کاربر.
به افرادی که برای سفر برنامه ریزی می کنند، اطلاعات تماس، نظرات و سطوح قیمت را برای موسسات در مسیر ارائه دهید.
با Places API (جدید) چه کاری می توانید انجام دهید
می توانید از Places API (جدید) برای گنجاندن ویژگی های زیر در برنامه های خود استفاده کنید:
نتایج جستجوی مکان را از انواع مختلف درخواست‌های کاربران، مانند ورودی متن، مکان‌های نزدیک، و جستارهای مبهم یا طبقه‌بندی شده کاربر ارائه دهید.
ویژگی های تکمیل خودکار را برای انواع مختلف جستجو، اعم از عبارت های متنی خاص یا جستارهای دسته بندی، فعال کنید.
نوع جزئیات بازگردانده شده درباره یک مکان، مانند ساعات کار، خلاصه، نظرات کاربران و یک عکس را اصلاح کنید.
عکس‌های باکیفیت را به مکان‌هایی که برنامه شما ارائه می‌کند اضافه کنید.
بسیاری از APIهای پلتفرم نقشه‌های Google از شناسه‌های مکان پشتیبانی می‌کنند، جایی که شناسه مکان به طور منحصربه‌فردی مکانی را در پایگاه داده Google Places و در Google Maps شناسایی می‌کند. راه‌های زیادی برای دریافت شناسه مکان وجود دارد، از جمله از طریق API Places (جدید)، اما همچنین از API Geocoding ، Routes API و Address Validation API .
هنگامی که یک شناسه مکان دارید، می‌توانید از Places API (جدید) برای درخواست جزئیات بیشتر درباره یک مؤسسه یا نقطه مورد علاقه خاص، مانند آدرس کامل، شماره تلفن، رتبه‌بندی کاربر، و نظرات آن استفاده کنید.
نحوه عملکرد Places API (جدید).
Places API (جدید) درخواست‌ها را به‌عنوان یک URL استاندارد با یک نقطه پایانی سرویس خاص، مانند /places یا places:searchText می‌پذیرد و یک پاسخ JSON را برمی‌گرداند. Places API (جدید) از مجوز توسط کلید API و نشانه OAuth پشتیبانی می کند. مثال زیر یک درخواست جزئیات مکان (جدید) برای بازگرداندن اجزای آدرس برای شناسه مکان با استفاده از یک کلید API ایجاد می کند:
مراحل زیر یک سناریوی مورد استفاده معمولی برای استفاده از سرویس Places API را پوشش می دهد. همانطور که راه حل خود را ایجاد می کنید، می توانید از نقاط پایانی اضافی مانند جستجوی نزدیک (جدید) و عکس های مکان (جدید) استفاده کنید.
بسیاری از API های پلتفرم نقشه های گوگل، شناسه مکان را به عنوان بخشی از پاسخ برمی گردانند. از شناسه‌های مکان برای دریافت جزئیات مکان (جدید) استفاده کنید.
4
برای یک مکان عکس بگیرید
Place Photos (جدید) به شما امکان می دهد به میلیون ها عکس ذخیره شده در پایگاه داده Places دسترسی داشته باشید. از عکس‌های مکان (جدید) برای دسترسی به عکس‌های یک مکان استفاده کنید.
تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Places API provides location data and imagery for establishments, geographic locations, and points of interest through various methods.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the Places API to create location-aware features, such as place search, autocomplete, details retrieval, and photo integration.\u003c/p\u003e\n"],["\u003cp\u003eThe Places API offers two versions: Places API and Places API (New), with differences outlined in a guide for choosing the best fit for your project.\u003c/p\u003e\n"],["\u003cp\u003eYou can access places data through requests to specific service endpoints using an API key or OAuth token, receiving responses in JSON or XML format.\u003c/p\u003e\n"],["\u003cp\u003eDetailed steps for using the API include setup, text search, place details retrieval using place IDs, and accessing place photos.\u003c/p\u003e\n"]]],[],null,["# Overview\n\nSelect platform: [Android](/maps/documentation/places/android-sdk/overview \"View this page for the Android platform docs.\") [iOS](/maps/documentation/places/ios-sdk/overview \"View this page for the iOS platform docs.\") [JavaScript](/maps/documentation/javascript/place \"View this page for the JavaScript platform docs.\") [Web Service](/maps/documentation/places/web-service/overview \"View this page for the Web Service platform docs.\") \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\nIntroduction\n------------\n\nThe Places API is a service that accepts HTTP requests for location data through a variety of methods. It returns formatted location data and imagery about establishments, geographic locations, or prominent points of interest. **Note:** Google Maps Platform provides separate versions of the Places library for [Android](/maps/documentation/places/android-sdk/overview), [iOS](/maps/documentation/places/ios-sdk/overview), and [JavaScript](/maps/documentation/javascript/places). We recommend that you use the version of the Places library specific to your platform. That is, if you are developing an Android app, you should use the Android version of Places.\n\nWhy use the Places API (New)\n----------------------------\n\nCreate location-aware features to make detailed location data\navailable to your users. The data available through the\nPlaces API (New) is built on one of the most accurate, up-to-date,\nand comprehensive place models of the real world. Here are example use\ncases for applications:\n\n- Display condo rentals within major metropolitan areas with results targeted specifically to cities.\n- Include place details in a pickup or delivery status update.\n- Display a list of parks in an area along with user-submitted photos and reviews.\n- Provide people planning trips with contact information, reviews, and price levels for establishments along the way.\n\n| **Note:** Places API (New) is the current version. Places API is now Legacy and can no longer be enabled. Legacy documentation and migration guides are available on the [Legacy](/maps/documentation/places/web-service/overview-legacy) tab.\n\nWhat can you do with the Places API (New)\n-----------------------------------------\n\nYou can use the Places API (New) to include the following features\nin your applications:\n\n- Provide place search results from different types of users queries, such as text input, nearby locations, and ambiguous or categorical user queries.\n- Enable autocomplete features for different search types, either specific text queries or categorical queries.\n- Refine the type of details returned about a place, such as operating hours, a summary, user reviews, and a photo.\n- Add high-quality photos to locations served by your application.\n\nMany Google Maps Platform APIs support [place IDs](/maps/documentation/places/web-service/place-id), where\nthe place ID uniquely identifies a place in the Google Places database and\non Google Maps. There are many ways to obtain a place ID, including from\nthe Places API (New), but also from the [Geocoding API](/maps/documentation/geocoding), [Routes API](/maps/documentation/routes), and [Address Validation API](/maps/documentation/address-validation).\n\nOnce you have a place ID, you can use the Places API (New) to\nrequest more details about a particular establishment or point of\ninterest, such as its complete address, phone number, user rating, and\nreviews.\n\nHow the Places API (New) works\n------------------------------\n\nPlaces API (New) accepts requests as a standard URL with a\nspecific service endpoint, such as `/places` or\n`places:searchText` and returns a JSON response.\nPlaces API (New) supports authorization by API key and OAuth token.\nThe following example makes a Place Details (New) request to return\nthe address components for a place ID using an API key: \n\n```html\nhttps://places.googleapis.com/v1/places/GyuEmsRBfy61i59si0?fields=addressComponents&key=YOUR_API_KEY\n```\n\nHow to use the Places API (New)\n-------------------------------\n\nThe steps below cover a typical use case scenario for using the Places API service. As you build out your solution, you can use additional endpoints, such as Nearby Search (New) and Place Photos (New).\n\n|---|---------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/elevation/cloud-setup) and complete the setup instructions that follow and then learn [how to use your API key](/maps/documentation/places/web-service/get-api-key). |\n| 2 | **Try a basic text search** | Issue a text search by using [Text Search (New)](/maps/documentation/places/web-service/text-search). |\n| 3 | **Use the place ID for more details** | Many Google Maps Platform APIs return a place ID as part of a response. Use place IDs to get [Place Details (New)](/maps/documentation/places/web-service/place-details). |\n| 4 | **Get a photo for a place** | Place Photos (New) gives you access to the millions of photos stored in the Places database. Use [Place Photos (New)](/maps/documentation/places/web-service/place-photos) to access photos for a place. |"]]
