برای تماس با این سرویس، توصیه می کنیم از کتابخانه های سرویس گیرنده ارائه شده توسط Google استفاده کنید. اگر برنامه شما نیاز به استفاده از کتابخانه های خود برای فراخوانی این سرویس دارد، هنگام درخواست API از اطلاعات زیر استفاده کنید.
سند کشف
Discovery Document یک ویژگی قابل خواندن توسط ماشین برای توصیف و مصرف API های REST است. از آن برای ساخت کتابخانه های سرویس گیرنده، پلاگین های IDE و سایر ابزارهایی که با Google API در تعامل هستند استفاده می شود. یک سرویس ممکن است چندین سند کشف را ارائه دهد. این سرویس سند کشف زیر را ارائه می دهد:
نقطه پایانی سرویس یک URL پایه است که آدرس شبکه یک سرویس API را مشخص می کند. یک سرویس ممکن است چندین نقطه پایانی سرویس داشته باشد. این سرویس دارای نقطه پایانی سرویس زیر است و همه URI های زیر مربوط به این نقطه پایانی سرویس هستند:
تاریخ آخرین به‌روزرسانی 2025-08-29 به‌وقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-08-29 به‌وقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Places API gives developers access to search and retrieval endpoints for places data.\u003c/p\u003e\n"],["\u003cp\u003eThe API offers functionalities such as place autocomplete, details retrieval, nearby search, and text-based search.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can retrieve photos associated with places using the \u003ccode\u003eplaces.photos\u003c/code\u003e resource.\u003c/p\u003e\n"],["\u003cp\u003eThe service endpoint for the Places API is \u003ccode\u003ehttps://places.googleapis.com\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eGoogle-provided client libraries are recommended for interacting with the API.\u003c/p\u003e\n"]]],["The Places API offers `v1.places` and `v1.places.photos` resources via the `places.googleapis.com` service. Developers can utilize Google-provided client libraries or their own to make API requests. The `v1.places` resource supports methods for place-related actions such as `autocomplete`, `get` (details), `searchNearby`, and `searchText`. The `v1.places.photos` resource's `getMedia` method retrieves photo media using a photo reference string. The service's base URL is `https://places.googleapis.com`.\n"],null,["# Places API (New)\n\nThe Places API allows developers to access a variety of search and retrieval endpoints for a Place.\n\n- [REST Resource: v1.places](#v1.places)\n- [REST Resource: v1.places.photos](#v1.places.photos)\n\nService: places.googleapis.com\n------------------------------\n\nTo call this service, we recommend that you use the Google-provided [client libraries](https://cloud.google.com/apis/docs/client-libraries-explained). If your application needs to use your own libraries to call this service, use the following information when you make the API requests.\n\n### Discovery document\n\nA [Discovery Document](https://developers.google.com/discovery/v1/reference/apis) is a machine-readable specification for describing and consuming REST APIs. It is used to build client libraries, IDE plugins, and other tools that interact with Google APIs. One service may provide multiple discovery documents. This service provides the following discovery document:\n\n- \u003chttps://places.googleapis.com/$discovery/rest?version=v1\u003e\n\n### Service endpoint\n\nA [service endpoint](https://cloud.google.com/apis/design/glossary#api_service_endpoint) is a base URL that specifies the network address of an API service. One service might have multiple service endpoints. This service has the following service endpoint and all URIs below are relative to this service endpoint:\n\n- `https://places.googleapis.com`\n\nREST Resource: [v1.places](/maps/documentation/places/web-service/reference/rest/v1/places)\n-------------------------------------------------------------------------------------------\n\n| Methods ||\n|----------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------|\n| [autocomplete](/maps/documentation/places/web-service/reference/rest/v1/places/autocomplete) | `POST /v1/places:autocomplete` Returns predictions for the given input. |\n| [get](/maps/documentation/places/web-service/reference/rest/v1/places/get) | `GET /v1/{name=places/*}` Get the details of a place based on its resource name, which is a string in the `places/{place_id}` format. |\n| [searchNearby](/maps/documentation/places/web-service/reference/rest/v1/places/searchNearby) | `POST /v1/places:searchNearby` Search for places near locations. |\n| [searchText](/maps/documentation/places/web-service/reference/rest/v1/places/searchText) | `POST /v1/places:searchText` Text query based place search. |\n\nREST Resource: [v1.places.photos](/maps/documentation/places/web-service/reference/rest/v1/places.photos)\n---------------------------------------------------------------------------------------------------------\n\n| Methods ||\n|---------------------------------------------------------------------------------------------|-------------------------------------------------------------------------------------------|\n| [getMedia](/maps/documentation/places/web-service/reference/rest/v1/places.photos/getMedia) | `GET /v1/{name=places/*/photos/*/media}` Get a photo media with a photo reference string. |"]]
