API Địa điểm là một dịch vụ chấp nhận các yêu cầu HTTP cho dữ liệu vị trí thông qua nhiều phương thức. API này trả về dữ liệu vị trí được định dạng và hình ảnh về các cơ sở, vị trí địa lý hoặc điểm yêu thích nổi bật.
Lý do sử dụng Places API (Mới)
Tạo các tính năng nhận biết vị trí để cung cấp dữ liệu vị trí chi tiết cho người dùng. Dữ liệu có sẵn thông qua API Địa điểm (Mới) được xây dựng dựa trên một trong những mô hình địa điểm chính xác, mới nhất và toàn diện nhất của thế giới thực. Sau đây là ví dụ về trường hợp sử dụng cho các ứng dụng:
Hiển thị các căn hộ cho thuê trong các khu đô thị lớn với kết quả được nhắm mục tiêu cụ thể theo thành phố.
Đưa thông tin chi tiết về địa điểm vào nội dung cập nhật trạng thái giao hàng hoặc đến lấy hàng.
Hiển thị danh sách công viên trong một khu vực cùng với hình ảnh và bài đánh giá do người dùng gửi.
Cung cấp cho những người đang lên kế hoạch cho chuyến đi thông tin liên hệ, bài đánh giá và mức giá của các cơ sở lưu trú dọc theo tuyến đường.
Những việc bạn có thể làm với Places API (Mới)
Bạn có thể sử dụng API Địa điểm (Mới) để đưa các tính năng sau vào ứng dụng của mình:
Cung cấp kết quả tìm kiếm địa điểm từ nhiều loại cụm từ tìm kiếm của người dùng, chẳng hạn như văn bản nhập, vị trí lân cận và cụm từ tìm kiếm mơ hồ hoặc mang tính phân loại của người dùng.
Bật tính năng tự động hoàn thành cho nhiều loại nội dung tìm kiếm, chẳng hạn như truy vấn văn bản cụ thể hoặc truy vấn theo danh mục.
Tinh chỉnh loại thông tin chi tiết được trả về về một địa điểm, chẳng hạn như giờ hoạt động, bản tóm tắt, bài đánh giá của người dùng và ảnh.
Thêm ảnh chất lượng cao vào các địa điểm mà ứng dụng của bạn phân phát.
Nhiều API của Nền tảng Google Maps hỗ trợ mã địa điểm, trong đó mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Có nhiều cách để lấy mã địa điểm, bao gồm cả từ API Địa điểm (Mới) nhưng cũng có thể lấy từ Geocoding API (API Địa chỉ), Routes API (API Tuyến đường) và Address Validation API (API Xác thực địa chỉ).
Sau khi có mã địa điểm, bạn có thể sử dụng API Địa điểm (Mới) để yêu cầu thêm thông tin chi tiết về một cơ sở hoặc điểm tham quan cụ thể, chẳng hạn như địa chỉ đầy đủ, số điện thoại, điểm xếp hạng của người dùng và bài đánh giá.
Cách hoạt động của Places API (Mới)
API Địa điểm (Mới) chấp nhận các yêu cầu dưới dạng URL chuẩn có điểm cuối dịch vụ cụ thể, chẳng hạn như /places hoặc places:searchText và trả về phản hồi JSON.
Places API (Mới) hỗ trợ uỷ quyền bằng khoá API và mã thông báo OAuth.
Ví dụ sau đây tạo một yêu cầu Chi tiết về địa điểm (Mới) để trả về các thành phần địa chỉ cho mã địa điểm bằng cách sử dụng khoá API:
Các bước bên dưới trình bày một trường hợp sử dụng điển hình để sử dụng dịch vụ API Địa điểm. Khi xây dựng giải pháp, bạn có thể sử dụng các điểm cuối bổ sung, chẳng hạn như Tìm kiếm lân cận (Mới) và Ảnh địa điểm (Mới).
Ảnh địa điểm (Mới) cho phép bạn truy cập vào hàng triệu ảnh được lưu trữ trong cơ sở dữ liệu Địa điểm. Sử dụng tính năng Ảnh địa điểm (Mới) để truy cập vào ảnh của một địa điểm.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-31 UTC."],[[["\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. |"]]
