PISO Maps API
Tài liệu API

Google Maps Local Results API

GET /api/maps/search — Tìm kiếm địa điểm gần một vị trí

Tìm kiếm doanh nghiệp và địa điểm theo từ khóa và vị trí. Trả về danh sách các địa điểm phù hợp kèm đánh giá, giá cả, giờ mở cửa và nhiều thông tin khác.

Endpoint

GET /api/maps/search

Headers

NameValueRequired
x-api-keyAPI key của bạn

Tham số truy vấn

NameTypeRequiredDefaultMô tả
qstringNội dung tìm kiếm
latnumberKhông10.801671Vĩ độ cho trung tâm tìm kiếm
lngnumberKhông106.61744Kinh độ cho trung tâm tìm kiếm

Ví dụ yêu cầu

curl "https://api.piso.dev/api/maps/search?q=highland&lat=10.801671&lng=106.61744" \
  -H "x-api-key: YOUR_API_KEY"

Ví dụ phản hồi

{
  "local_result": [
    {
      "data_id": "0x31752bb396ca47f9:0x237d4c6fae045dd9",
      "place_id": "ChIJ-fGSpjOo1jERVN0ErG9MfSM",
      "title": "Highlands Coffee",
      "type": "cafe",
      "rating": 4.2,
      "reviews": 1234,
      "pricing": {
        "min": 30000,
        "max": 65000
      },
      "contacts": {
        "phone": "02838277979",
        "website": "https://highlandscoffee.com.vn"
      },
      "location": {
        "latitude": 10.7765,
        "longitude": 106.7008,
        "timezone": "Asia/Ho_Chi_Minh",
        "country_code": "VN",
        "address": {
          "full": "135 Hai Bà Trưng, Bến Nghé, Quận 1, Hồ Chí Minh, Vietnam",
          "street": "135 Hai Bà Trưng",
          "ward": "Bến Nghé",
          "city": "Quận 1",
          "country": "Việt Nam"
        }
      },
      "open_state": {
        "is_open_now": true,
        "text": "Đang mở cửa"
      },
      "opening_hours": [
        {
          "day": "Thứ Hai",
          "hours": "07:00–22:00"
        }
      ],
      "features": {
        "accessibility": ["Lối vào cho xe lăn"],
        "parking": ["Bãi đỗ xe miễn phí"],
        "payments": ["Thẻ ghi nợ", "Thẻ tín dụng"],
        "service_options": ["Dùng tại chỗ", "Mang đi", "Giao hàng"],
        "other": []
      }
    }
  ]
}

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

FieldTypeMô tả
local_resultarrayDanh sách các địa điểm phù hợp
local_result[].data_idstringID nội bộ dùng cho Place Detail
local_result[].place_idstringGoogle Maps place ID
local_result[].titlestringTên địa điểm
local_result[].typestringDanh mục (ví dụ: cafe, nhà hàng)
local_result[].ratingnumberĐánh giá trung bình (1.0–5.0)
local_result[].reviewsintegerTổng số lượt đánh giá
local_result[].pricingobjectKhoảng giá: { min, max }
local_result[].contactsobjectThông tin liên hệ: { phone, website }
local_result[].locationobjectDữ liệu vị trí (lat, lng, địa chỉ, timezone, country_code)
local_result[].location.addressobjectĐịa chỉ có cấu trúc: { full, street, ward, city, country }
local_result[].open_stateobjectTrạng thái hiện tại: { is_open_now, text }
local_result[].opening_hoursarrayGiờ mở cửa hàng tuần: [{ day, hours }]
local_result[].featuresobjectTiện nghi (accessibility, parking, payments, service_options)

Lỗi

StatusÝ nghĩa
401Thiếu hoặc không hợp lệ API key
422Tham số truy vấn không hợp lệ hoặc thiếu
429Vượt quá giới hạn tốc độ
500Lỗi máy chủ nội bộ

Trong trang này