TỔNG QUAN
Place Detail API là dịch vụ lấy thông tin chi tiết về một địa điểm. Thông tin này có thể bao gồm vị trí địa lý chính xác, địa chỉ, loại hình kinh doanh (nếu áp dụng), các tính năng đặc biệt của địa điểm đó như giá cả, đánh giá, thời gian hoạt động và thông tin liên hệ. Goong Place Detail API cho phép truy vấn thông tin chi tiết của một địa điểm dựa trên ID của địa điểm đó.
Vì sao nên sử dụng Place Detail
Tạo các tính năng nhận biết vị trí để giúp người dùng của bạn dễ dàng lấy dữ liệu vị trí chi tiết. Dữ liệu có sẵn thông qua Place Detail được xây dựng 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. Một số ứng dụng thực tế sau đây:
- Hiển thị thông tin chi tiết của nhà hàng, quán ăn, khách sạn, các dịch vụ công cộng về vị trí, tình trạng hoạt động, thông tin liên hệ, đánh giá và hình ảnh cụ thể. Cung cấp thông tin cho quá trình thực hiện kế hoạch một chuyến đi.
- Thêm thông tin chi tiết về địa điểm.
Ứng dụng thực tế của Place Detail
Bạn có thể sử dụng Place Detail để lấy thông tin chi tiết được trả về về một địa điểm.
Nhiều API trên nền tảng Goong hỗ trợ lấy mã địa điểm, trong đó mã địa điểm sẽ giúp nhận dạng riêng một địa điểm trong cơ sở dữ liệu địa điểm của Goong và trên Goong Maps. Có nhiều cách để lấy mã địa điểm, bao gồm cả từ Autocomplete API và từ Geocode API.
Sau khi có mã địa điểm, bạn có thể sử dụng Place Detail để yêu cầu thêm thông tin chi tiết về một cơ sở hoặc địa điểm yêu thích 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 THỨC TÍCH HỢP GOONG PLACE DETAIL
Bắt đầu:
Đầu tiên, bạn phải đăng ký tài khoản và tạo API key của Goong theo hướng dẫn chi tiết tại đây.
URL: /place/detail
Phương thức: GET
Ví dụ về request:
curl "https://rsapi.goong.io/place/detail?place_id=Hobn8WqBW6rsKtKq2PDrVKp4BJNRtiILxTQbB__muXgRB3v8GRDTfkp_6lc4cbLw%2F5PUgWrMDrSI%2FxlqDBt5XA%3D%3D.ZXhwYW5kMA%3D%3D&api_key={YOUR_API_KEY}"
Tham số |
Mô tả |
Ví dụ |
place_id |
Id của địa điểm | lmlZtUpGewN1jaY0Pn2U_HamlVK-fabRXtBZAqNqmPW
4ZFEgv9O69WamQSG_dovSX7ebEKlpLXbcjr1dlEQbAm aLbxW9cO-QZLRCVpRxlP0CjlECopyEc5SmWSmUcu_UO |
Ví dụ về response:
application/json { "result": { "place_id": "Hobn8WqBW6rsKtKq2PDrVKp4BJNRtiILxTQbB__muXgRB3v8GRDTfkp_6lc4cbLw /5PUgWrMDrSI/xlqDBt5XA==.ZXhwYW5kMA==", "formatted_address": "Phường Trung Hòa, Quận Cầu Giấy, Thành phố Hà Nội", "geometry": { "location": { "lat": 21.0137625240001, "lng": 105.798267363 } }, "name": "91 Trung Kính" }, "status": "OK" }
Tham số | Mô tả | Ví dụ |
result | Chứa một mảng thông tin địa chỉ và thông tin hình học được mã hoá địa lý. | |
place_id | Id của địa điểm. | 0WmA4vbeody2J9AEvVM9YE3ZN85z7Mrw |
formatted_address |
Bao gồm tất cả các thông tin cần thiết như số nhà, tên đường, quận/huyện, thành phố,/tỉnh và quốc gia. Thường được sử dụng để hiển thị thông tin chi tiết về vị trí hoặc địa chỉ người dùng. |
Phường Trung Hòa, Quận Cầu Giấy, Thành phố Hà Nội |
geometry | Là một phần dữ liệu mô tả vị trí địa lý của một đối tượng, bao gồm kinh độ và vĩ độ. |
“geometry”: {
“location”: {
“lat”: 20.954041207000046,
“lng”: 105.93929095700008
}
}
|
location | Tọa độ điểm kinh độ và vĩ độ. |
21.0137625240001, 105.798267363 |
name | Tên địa điểm. | 226 Vạn Phúc |
status | Mã trạng thái “ok” nghĩa là thành công, khác là thất bại. | ok |