TỔNG QUAN
Place detail” (chi tiết địa điểm) là thông tin cụ thể và chi tiết về một địa điểm cụ thể. 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 cung cấp các API cho phép truy vấn chi tiết của một địa điểm dựa trên tên hoặc ID của địa điểm.
Vì sao nên sử dụng Place API
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 cung cấp dữ liệu vị trí chi tiết. Dữ liệu có sẵn thông qua Places API đượ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á, 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 trong thông tin cập nhật về trạng thái đến lấy hàng hoặc giao hàng.
- Hiển thị danh sách các công viên trong một khu vực cùng với ảnh và bài đánh giá do người dùng gửi.
Ứng dụng thực tế của Place detail
Bạn có thể sử dụng Places API để đưa những 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ư nhập văn bản, vị trí lân cận và cụm từ tìm kiếm không rõ ràng hoặc theo danh mục của người dùng.
- Bật tính năng tự động hoàn thành cho nhiều loại tìm kiếm, có thể là một số cụm từ tìm kiếm dạng văn bản hoặc cụm từ tìm kiếm 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 những vị trí mà ứng dụng của bạn phân phát.
Nhiều API Nền tảng Goong hỗ trợ mã địa điểm trong đó mã địa điểm 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ừ API địa điểm và từ API mã hóa địa lý, API tuyến đường và API xác thực địa chỉ.
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:
Đường link: /Place/Detail
Phương thức: GET
Ví dụ về request (Đầu vào)
$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 | 0WmA4vbeody2J9AEvVM9YE3ZN85z7Mrw |
sessiontoken | Session token | a68dfa01-a5aa-47d1-aaa7-a3184896b283 |
Ví dụ về Respone trả về (Đầu ra)
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 (Mã) của địa điểm | 0WmA4vbeody2J9AEvVM9YE3ZN85z7Mrw |
formatted_address | là một chuỗi ký tự mô tả một địa chỉ cụ thể dưới dạng đã định dạng để dễ đọc và hiểu.
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 | Geometry là một phần dữ liệu mô tả vị trí địa lý của một đối tượng như điểm, đường, hoặc vùng trên bản đồ. | |
location | Tọa độ điểm latlon | 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 | ok |