Nearby Search

API Nearby Search GTEL MAPS cho phép tìm kiếm địa điểm xung quanh một vị trí cho trước.

---

Dịch vụ Nearby Search

Loading...

Tham số

Tham số bắt buộc	Kiểu dữ liệu	Mô tả
location	string	Vĩ độ và kinh độ để tìm kiếm xung quanh, theo định dạng lat,lng.
types	string	Loại địa điểm cần tìm kiếm có thể là một hoặc nhiều loại, phân cách bằng dấu phẩy. Ví dụ: hospital,restaurant. Địa điểm phổ biến: - accident_blackspot: Điểm đen tai nạn. - airport: Sân bay. - amusement_park: Công viên giải trí. - bank: Ngân hàng. - cafe: Quán cà phê. - charging_station: Trạm sạc. - church: Nhà thờ. - clinic: Phòng khám. - college: Trường cao đẳng. - company: Công ty. - convention_center: Trung tâm hội nghị. - event_planner: Nhà tổ chức sự kiện. - fire_station: Trạm cứu hỏa. - fitness: Trung tâm thể dục. - gas_station: Trạm xăng. - government_office: Cơ quan chính phủ. - gym: Phòng gym. - hospital: Bệnh viện. - hotel: Khách sạn. - insurance_agency: Đại lý bảo hiểm. - landmark: Địa danh. - market: Chợ. - medical_center: Trung tâm y tế. - medical_station: Trạm y tế. - museum: Bảo tàng. - national_park: Vườn quốc gia. - park: Công viên. - police: Cơ quan công an. - post_office: Bưu điện. - restaurant: Nhà hàng. - roadside_assistance: Hỗ trợ bên đường. - sports_field: Sân thể thao. - store: Cửa hàng. - toll_booth: Trạm thu phí. - traffic_camera: Camera giao thông. - traffic_police: Cảnh sát giao thông. - university: Đại học. - vehicle_inspection: Trạm đăng kiểm.

Tham số tuỳ chọn	Kiểu dữ liệu	Mô tả
bbox	string	Một hộp giới hạn để giới hạn vùng tìm kiếm, theo định dạng top_left_lat,top_left_lng,bottom_right_lat,bottom_right_lng. Nếu được cung cấp, radius sẽ bị bỏ qua.
keyword	string	Từ khoá tìm kiếm, ưu tiên tìm kiếm các địa điểm theo loại địa điểm từ đó tìm kiếm theo từ khóa. Ví dụ: Bệnh viện.
radius	integer	Bán kính tìm kiếm tính bằng mét. Bỏ qua nếu bbox được cung cấp. Mặc định là 10000.
size	integer	Số lượng kết quả trả về nếu không được cung cấp mặc định là 10.
pageToken	string	Token được sử dụng để gọi tải thêm (load more) khi phân trang cho các lần gửi yêu cầu tiếp theo.Token cho trang tiếp theo sẽ được trả về tại meta.pagination.nextPageToken hoặc nằm trong trường pageToken của từng mục (item) trong dữ liệu.

Headers

Header	Kiểu dữ liệu	Mô tả
app-version	string	Bắt buộc. Phiên bản API: 1.1

Yêu cầu mẫu: Dịch vụ Nearby Search

Loading API request...

Cấu trúc phản hồi mẫu: Dịch vụ Nearby Search

Thông tin phân trang

{
  "meta": {
    "pagination": {
      "nextPageToken": "Mã phân trang tiếp theo"
    }
  }
}

Thông tin chi tiết địa điểm

Thuộc tính	Kiểu dữ liệu	Mô tả
id	string	ID của địa điểm.
types	string[]	Danh sách loại địa điểm (ví dụ: "hospital", "restaurant").
formattedAddress	string	Địa chỉ định dạng đầy đủ.
nationalPhoneNumber	string	Số điện thoại nội địa.
internationalPhoneNumber	string	Số điện thoại quốc tế.
websiteUri	string	Website (nếu có).
email	string	Địa chỉ email.
distance	number	Khoảng cách từ vị trí tìm kiếm (tính bằng mét).
pageToken	string	Mã phân trang cho mục (item).
addressComponents.longText	string	Tên đầy đủ của thành phần địa chỉ.
addressComponents.shortText	string	Tên rút gọn của thành phần địa chỉ.
addressComponents.types	string[]	Danh sách loại thành phần địa chỉ (street_number, route, country, administrative_area_level_1, ...).
plusCode.compoundCode	string	Mã địa phương.
plusCode.globalCode	string	Mã toàn cầu.
location.latitude	number	Vĩ độ.
location.longitude	number	Kinh độ.
geometry.type	string	Loại hình học (ví dụ "Point").
geometry.coordinates	number[]	Tọa độ dạng [longitude, latitude].
viewport.low.latitude	number	Vĩ độ của điểm thấp nhất.
viewport.low.longitude	number	Kinh độ của điểm thấp nhất.
viewport.high.latitude	number	Vĩ độ của điểm cao nhất.
viewport.high.longitude	number	Kinh độ của điểm cao nhất.
displayName.text	string	Tên địa điểm hiển thị.
displayName.languageCode	string	Mã ngôn ngữ của tên hiển thị.

Phản hồi mẫu: Dịch vụ Nearby Search

{
  "statusCode": 200,
  "data": [
    {
      "id": "gm:poi:359a2b86-a269-49ab-8338-d6930379dee3",
      "types": ["company"],
      "nationalPhoneNumber": "",
      "internationalPhoneNumber": "",
      "formattedAddress": "22 Phương Mai, Phường Kim Liên, Thành phố Hà Nội, Việt Nam",
      "addressComponents": [
        { "longText": "22", "shortText": "22", "types": ["street_number"] },
        { "longText": "Phương Mai", "shortText": "Phương Mai", "types": ["route"] },
        {
          "longText": "Phường Kim Liên",
          "shortText": "Kim Liên",
          "adminCode": "00226",
          "adminLevel": "Phường",
          "types": ["administrative_area_level_2"]
        },
        {
          "longText": "Thành phố Hà Nội",
          "shortText": "Hà Nội",
          "adminCode": "01",
          "adminLevel": "Thành phố",
          "types": ["administrative_area_level_1"]
        },
        { "longText": "", "shortText": "", "types": ["postal_code"] },
        { "longText": "Việt Nam", "shortText": "VN", "types": ["country"] }
      ],
      "plusCode": {
        "compoundCode": "2R4Q+CM, Phường Kim Liên, Thành phố Hà Nội, Việt Nam",
        "globalCode": "7PH72R4Q+CM"
      },
      "location": { "latitude": 21.006089, "longitude": 105.839208 },
      "geometry": { "type": "Point", "coordinates": [105.839208, 21.006089] },
      "viewport": {
        "low": { "latitude": 21.002495755300036, "longitude": 105.8353589568875 },
        "high": { "latitude": 21.009682244699963, "longitude": 105.8430570431125 }
      },
      "websiteUri": "",
      "email": "",
      "adrFormatAddress": "",
      "displayName": { "text": "công ty cô phân chăm soc sưc khoe Nam Viêt", "languageCode": "vi" },
      "timeZone": { "id": "Asia/Ho_Chi_Minh" },
      "extras": { "is_deprecated": false },
      "distance": 0.05737568765516521,
      "pageToken": "WzAuMDU3Mzc1Njg3NjU1MTY1MjEsIjM1OWEyYjg2LWEyNjktNDlhYi04MzM4LWQ2OTMwMzc5ZGVlMyJd"
    },
    {
      "id": "gm:poi:8a29d094-8395-4402-a488-cdc91d37eae5",
      "types": ["company"],
      "nationalPhoneNumber": "",
      "internationalPhoneNumber": "",
      "formattedAddress": "38/4B- D20 Phương Mai, Phường Kim Liên, Thành phố Hà Nội, Việt Nam",
      "addressComponents": [
        { "longText": "38/4B- D20", "shortText": "38/4B- D20", "types": ["street_number"] },
        { "longText": "Phương Mai", "shortText": "Phương Mai", "types": ["route"] },
        {
          "longText": "Phường Kim Liên",
          "shortText": "Kim Liên",
          "adminCode": "00226",
          "adminLevel": "Phường",
          "types": ["administrative_area_level_2"]
        },
        {
          "longText": "Thành phố Hà Nội",
          "shortText": "Hà Nội",
          "adminCode": "01",
          "adminLevel": "Thành phố",
          "types": ["administrative_area_level_1"]
        },
        { "longText": "", "shortText": "", "types": ["postal_code"] },
        { "longText": "Việt Nam", "shortText": "VN", "types": ["country"] }
      ],
      "plusCode": {
        "compoundCode": "2R4Q+FH, Phường Kim Liên, Thành phố Hà Nội, Việt Nam",
        "globalCode": "7PH72R4Q+FH"
      },
      "location": { "latitude": 21.006241, "longitude": 105.838935 },
      "geometry": { "type": "Point", "coordinates": [105.838935, 21.006241] },
      "viewport": {
        "low": { "latitude": 21.002647755300035, "longitude": 105.83508595296657 },
        "high": { "latitude": 21.009834244699963, "longitude": 105.84278404703345 }
      },
      "websiteUri": "",
      "email": "",
      "adrFormatAddress": "",
      "displayName": {
        "text": "Công Ty TNHH Nghiên Cứu Chế Tạo Và Chuyển Giao Công Nghệ Thiết Bị Y Tế",
        "languageCode": "vi"
      },
      "timeZone": { "id": "Asia/Ho_Chi_Minh" },
      "extras": { "is_deprecated": false },
      "distance": 0.06931808943443309,
      "pageToken": "WzAuMDY5MzE4MDg5NDM0NDMzMDksIjhhMjlkMDk0LTgzOTUtNDQwMi1hNDg4LWNkYzkxZDM3ZWFlNSJd"
    }
  ],
  "meta": {
    "pagination": {
      "nextPageToken": "WzAuMDY5MzE4MDg5NDM0NDMzMDksIjhhMjlkMDk0LTgzOTUtNDQwMi1hNDg4LWNkYzkxZDM3ZWFlNSJd"
    }
  },
  "licence": "© GTEL Maps"
}