Place Detail API

Truy xuất thông tin toàn diện về một địa điểm bao gồm mô tả, đánh giá, ảnh, giờ cao điểm và nhiều hơn nữa.

I. Endpoint

GET https://api.pisomap.tech/api/maps/place

II. Headers

Name	Value	Required
`x-api-key`	API key của bạn	Có

III. Tham số truy vấn

Name	Type	Required	Default	Mô tả
`data_id`	string	Có	—	Định danh địa điểm từ Autocomplete hoặc Search
`lat`	number	Không	—	Vĩ độ hiện tại của bạn
`lng`	number	Không	—	Kinh độ hiện tại của bạn

IV. Ví dụ

Địa điểm: Highlands Coffee - Aeon Mall Tân Phú data_id: 0x31752bb396ca47f9:0x237d4c6fae045dd9 Tọa độ: 10.801698799999999, 106.6175257

curl "https://api.pisomap.tech/api/maps/place?data_id=0x31752bb396ca47f9:0x237d4c6fae045dd9&lat=10.801698799999999&lng=106.6175257" \
  -H "x-api-key: YOUR_API_KEY"

Phản hồi:

{
  "place_result": {
    "data_id": "0x31752bb396ca47f9:0x237d4c6fae045dd9",
    "title": "Highlands Coffee - Aeon Mall Tân Phú",
    "description": "",
    "type": "COFFEE",
    "rating": 4,
    "reviews": 441,
    "pricing": {
      "min": 1,
      "max": 100000
    },
    "contacts": {
      "phone": "028 7101 6768",
      "website": "https://www.foody.vn/ho-chi-minh/highlands-coffee-aeon-mall-tan-phu"
    },
    "location": {
      "address": {
        "full": "30 Tân Thắng, Celadon City, Tân Sơn Nhì, Hồ Chí Minh 700000, Việt Nam",
        "street": "30 Tân Thắng, Celadon City",
        "ward": "Tân Sơn Nhì",
        "city": "Hồ Chí Minh 700000",
        "country": "Việt Nam"
      },
      "latitude": 10.801698799999999,
      "longitude": 106.6175257,
      "timezone": "Asia/Saigon",
      "country_code": "VN"
    },
    "global_plus_code": "7P28RJ29+M2",
    "open_state": {
      "is_open_now": true,
      "text": "Đang mở cửa · Đóng cửa vào 21:00"
    },
    "opening_hours": [
      { "day": "Thứ Hai", "hours": "07:00–21:00" },
      { "day": "Thứ Ba", "hours": "07:00–21:00" },
      { "day": "Thứ Tư", "hours": "07:00–21:00" },
      { "day": "Thứ Năm", "hours": "07:00–21:00" },
      { "day": "Thứ Sáu", "hours": "07:00–21:00" },
      { "day": "Thứ Bảy", "hours": "07:00–21:00" },
      { "day": "Chủ Nhật", "hours": "07:00–21:00" }
    ],
    "features": {
      "accessibility": ["has_wheelchair_accessible_restroom"],
      "parking": ["has_parking_lot_free", "parking_availability"],
      "payments": ["pay_mobile_nfc", "pay_debit_card", "pay_credit_card"],
      "service_options": ["has_delivery", "has_takeout"],
      "other": ["serves_dine_in", "serves_coffee_notable", "serves_dessert_notable", "serves_tea_notable", "serves_coffee", "quick_bite", "has_restroom", "feels_cozy", "suitable_for_groups", "welcomes_children"]
    },
    "popular_times": [
      {
        "day": "Chủ Nhật",
        "hours": [
          { "hour": 9, "occupancy_percent": 87, "status": "Đông khách như mọi khi", "time_label": "09 giờ" },
          { "hour": 10, "occupancy_percent": 92, "status": "Đông khách như mọi khi", "time_label": "10 giờ" },
          { "hour": 11, "occupancy_percent": 100, "status": "Đông khách như mọi khi", "time_label": "11 giờ" },
          { "hour": 12, "occupancy_percent": 82, "status": "Đông khách như mọi khi", "time_label": "12 giờ" }
        ]
      },
      {
        "day": "Thứ Hai",
        "hours": [
          { "hour": 7, "occupancy_percent": 45, "status": "Thường không quá đông đúc", "time_label": "07 giờ" },
          { "hour": 8, "occupancy_percent": 45, "status": "Thường không quá đông đúc", "time_label": "08 giờ" },
          { "hour": 12, "occupancy_percent": 55, "status": "Thường hơi đông đúc", "time_label": "12 giờ" },
          { "hour": 19, "occupancy_percent": 61, "status": "Thường hơi đông đúc", "time_label": "19 giờ" }
        ]
      }
    ],
    "review_list": [
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT25aellrMVZSVFJWU25kTFExZHZhRU5oVWsxQ1NHYxAB",
        "author_name": "Sherry Dollette",
        "author_profile_pic": "https://lh3.googleusercontent.com/a-/ALV-UjXI2Arbh7Fo_uopTclrxLAU2hZk6IbswYWND7sc8d8UV2sTp2b3=s120-c-rp-mo-br100",
        "rating": 5,
        "text": "mình đi ngay cn lúc 9h10, chắc sắp đóng cửa với nhân viên mắc dọn :) nên lúc mình order, nhân viên thu ngân thể hiện thái độ trễ nãi rồi còn đùn đẩy cho 1 bạn khác order thay...",
        "photos": [
          {
            "id": "CIABIhAjFsYbZ2DwqgTnbBWwu-OI",
            "url": "https://lh3.googleusercontent.com/grass-cs/ANxoTn11LpQoUvx2AL7CqJrD2cvLUCConDTNFYxtqdVcMfsGDxrtUNO54YiCcoFeddaxeBqtn-4vc8TZZsuHgyFRly47f3KR4zNR7Od0VtLPYb8KRErCL-ShJzkBI-EDIaJKYSZalzGBK8nwTlQT=s0",
            "width": 3024,
            "height": 4032
          }
        ]
      },
      {
        "review_id": "Ci9DQUlRQUNvZENodHljRjlvT2tWMU1sTkhiV3ByWkVGVk5GaEJSSHBhUzA5TVRGRRAB",
        "author_name": "Hiếu Trần",
        "author_profile_pic": "https://lh3.googleusercontent.com/a-/ALV-UjU2lm7ApLvLWZTB9BcMEQ0F3fDEc1oJT2Alf2Vv6i9XK2j_kGar=s120-c-rp-mo-ba12-br100",
        "rating": 5,
        "text": "Highlands Aeon Tân Phú có không gian rộng, máy lạnh mát rượi, rất hợp để ngồi làm việc hoặc nghỉ chân sau khi shopping. Phục vụ nhanh dù quán khá đông.",
        "photos": [
          {
            "id": "CIABIhBEh92eWgtIFZeEl3znp04B",
            "url": "https://lh3.googleusercontent.com/grass-cs/ANxoTn0FACziWLTdAq4Xc5RGXnnFxMD_teUnQB_uli9qXIgpMEXzCohN7CO03T5alTpw5W4BKYw5ZJx0QJ1azvy6GpBqCj-lJvjlWRyNeytUhPuU8hIMamAf7OHFxgu8h_Iu1wOKjkL0hxd_-y9f=s0",
            "width": 1080,
            "height": 1920
          }
        ]
      }
    ],
    "photos": [
      {
        "category_id": "CgIgAQ==",
        "category_label": "Tất cả",
        "media": [
          {
            "id": "CIABIhDCl_aDtp2mpF8qZhoaq09H",
            "url": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAHwVJeChoP_0YBTl3Svd1bm_8xuR5a5h3vG0PuyfBDfEddO-DDKKVSQI2AXij_sczy9XKf4eu3yD73hig64zf_V9O6oNlA7pBfquR9vQhAfykR5v3bNdA97XenIkYbwa1Xl2WwErF9OmPcG=s0",
            "width": 1280,
            "height": 960
          }
        ]
      },
      {
        "category_id": "CgIYIQ==",
        "category_label": "Thực đơn",
        "media": [
          {
            "id": "CIABIhBG7O-R0HC5459gofD8SlZM",
            "url": "https://lh3.googleusercontent.com/gps-cs-s/APNQkAFXK10QTj-EdGQAP0_tKWIA9VtqmfGPlHP-MdVzKax2UHDh2-BjaBhJFeiCkw3O2iuMGisN9f-fmf5HKa3f0s6f0hmRAq_6WrOzL8CeoDislQ-X23SYYR0kxXeHPbvXxT65cxEIIQLxP9Yr=s0",
            "width": 4716,
            "height": 3540
          }
        ]
      }
    ],
    "link_search_value": "https://api.pisomap.tech/api/maps/search?q=Highlands%20Coffee%20-%20Aeon%20Mall%20T%C3%A2n%20Ph%C3%BA&lat=10,801698799999999&lng=106,6175257",
    "link_place_detail": "https://api.pisomap.tech/api/maps/place?data_id=0x31752bb396ca47f9%3A0x237d4c6fae045dd9",
    "link_google_maps": "https://www.google.com/maps/place/?cid=0x31752bb396ca47f9%3A0x237d4c6fae045dd9",
    "link_docs": "https://docs.pisomap.tech/vi/api-docs/place-detail"
  }
}

V. Các trường phản hồi

Field	Type	Mô tả
Field	Type	Mô tả
-------	------	-------
`place_result`	object	Đối tượng chi tiết địa điểm
`data_id`	string	Định danh nội bộ của địa điểm
`title`	string	Tên của địa điểm
`description`	string	Mô tả của địa điểm
`type`	string	Danh mục của địa điểm lấy từ Google Maps (vd: COFFEE, RESTAURANT)
`rating`	number	Đánh giá trung bình của địa điểm (1.0–5.0)
`reviews`	integer	Tổng số lượt đánh giá của địa điểm
`pricing`	object	Khoảng giá của địa điểm `{ min, max }`
`pricing.min`	number	Giá thấp nhất của địa điểm (VNĐ)
`pricing.max`	number	Giá cao nhất của địa điểm (VNĐ)
`contacts`	object	Thông tin liên hệ của địa điểm
`contacts.phone`	string	Số điện thoại của địa điểm
`contacts.website`	string	Trang web của địa điểm
`location`	object	Dữ liệu vị trí của địa điểm
`location.address`	object	Địa chỉ chi tiết của địa điểm
`location.address.full`	string	Địa chỉ đầy đủ của địa điểm
`location.address.street`	string	Tên đường/phố của địa điểm
`location.address.ward`	string	Phường/xã của địa điểm
`location.address.city`	string	Thành phố của địa điểm
`location.address.country`	string	Quốc gia của địa điểm
`location.latitude`	number	Vĩ độ của địa điểm
`location.longitude`	number	Kinh độ của địa điểm
`location.timezone`	string	Múi giờ của địa điểm (vd: Asia/Saigon)
`location.country_code`	string	Mã quốc gia của địa điểm (vd: VN)
`global_plus_code`	string	Mã plus code cho vị trí của địa điểm
`open_state`	object	Trạng thái mở cửa của địa điểm
`open_state.is_open_now`	boolean	Địa điểm có đang mở cửa hay không
`open_state.text`	string	Trạng thái giờ hoạt động dạng chữ của địa điểm
`opening_hours`	array	Giờ mở cửa hàng tuần của địa điểm
`opening_hours[].day`	string	Ngày trong tuần (vd: Thứ Hai, Thứ Ba,...)
`opening_hours[].hours`	string	Giờ hoạt động của địa điểm (vd: 07:00–21:00)
`features`	object	Tiện nghi của địa điểm
`features.accessibility`	array	Các tùy chọn tiếp cận của địa điểm
`features.parking`	array	Các tùy chọn đỗ xe của địa điểm
`features.payments`	array	Phương thức thanh toán được chấp nhận của địa điểm
`features.service_options`	array	Các tùy chọn dịch vụ của địa điểm (vd: takeout, delivery)
`features.other`	array	Các thuộc tính khác của địa điểm bao gồm không gian (vd: cozy, contemporary, historic), ẩm thực (vd: serves_coffee, serves_breakfast, quick_bite), đối tượng khách (vd: suitable_for_groups, welcomes_children, popular_with_tourists) và các tiện ích khác (vd: has_restroom, has_live_music, serves_alcohol)
`popular_times`	array	Mức độ đông đúc theo từng giờ trong ngày của địa điểm
`popular_times[].day`	string	Ngày trong tuần (vd: Chủ Nhật, Thứ Hai,...)
`popular_times[].hours`	array	Mảng dữ liệu đông đúc theo từng giờ của địa điểm
`popular_times[].hours[].hour`	integer	Giờ trong ngày (0–23)
`popular_times[].hours[].occupancy_percent`	integer	Phần trăm khách (0–100)
`popular_times[].hours[].status`	string	Trạng thái đông đúc của địa điểm (vd: 'Đông khách như mọi khi', 'Thường hơi đông đúc')
`popular_times[].hours[].time_label`	string	Nhãn giờ hiển thị của địa điểm (vd: '09 giờ', '10 giờ')
`review_list`	array	Danh sách đánh giá của người dùng cho địa điểm
`review_list[].review_id`	string	Mã định danh của bài đánh giá
`review_list[].author_name`	string	Tên tác giả của bài đánh giá
`review_list[].author_profile_pic`	string	URL ảnh đại diện của tác giả
`review_list[].rating`	integer	Điểm đánh giá (1–5)
`review_list[].text`	string	Nội dung bình luận của bài đánh giá
`review_list[].photos`	array	Ảnh kèm theo của bài đánh giá
`review_list[].photos[].id`	string	Mã định danh của ảnh
`review_list[].photos[].url`	string	URL của ảnh
`review_list[].photos[].width`	integer	Chiều rộng của ảnh (px)
`review_list[].photos[].height`	integer	Chiều cao của ảnh (px)
`photos`	array	Thư viện ảnh của địa điểm được phân loại theo danh mục
`photos[].category_id`	string	Mã định danh của danh mục ảnh
`photos[].category_label`	string	Nhãn danh mục (vd: 'Tất cả', 'Nội thất', 'Thực đơn', 'Mới nhất')
`photos[].media`	array	Mảng các ảnh trong danh mục
`photos[].media[].id`	string	Mã định danh của ảnh
`photos[].media[].url`	string	URL của ảnh
`photos[].media[].width`	integer	Chiều rộng của ảnh (px)
`photos[].media[].height`	integer	Chiều cao của ảnh (px)
`link_search_value`	string	Liên kết đến Search API của địa điểm
`link_place_detail`	string	Liên kết đến Place Detail API của địa điểm
`link_google_maps`	string	Liên kết đến Google Maps của địa điểm
`link_docs`	string	Liên kết đến tài liệu API của địa điểm

I. Endpoint

II. Headers

III. Tham số truy vấn

IV. Ví dụ

V. Các trường phản hồi

Trong trang này