PLACE DETAIL – THÔNG TIN CHI TIẾT ĐỊA ĐIỂM

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ừ API Autocomplete và từ API Geocode.

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