Chuyển tới nội dung chính
Phiên bản: v1.0

Forward Geocoding

API Forward Geocoding GTEL MAPS cho phép tìm kiếm một địa điểm bằng chuỗi văn bản và trả về địa chỉ được chuẩn hóa, ngữ cảnh địa lý và tọa độ của địa điểm đó.

Dịch vụ Forward Geocoding​

Loading...
Tham số bắt buộcKiểu dữ liệuMô tả
textstringĐịa chỉ muốn tra cứu có thể là đường, thành phố, v.v.
Tham số tuỳ chọnKiểu dữ liệuMô tả
typesstringLoạ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.
next_page_tokenstringToken đượ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.next_page_token.
sizeintegerSố lượng kết quả trả về nếu không được cung cấp mặc định là 10.
region_codeintegerLọc kết quả theo mã tỉnh/thành phố. Chỉ trả về địa chỉ thuộc tỉnh/thành phố có mã này. Xem danh sách mã tại đây.
county_codeintegerLọc kết quả theo mã huyện/quận. Chỉ trả về địa chỉ thuộc huyện/quận có mã này. Xem danh sách mã tại đây.
localadmin_codeintegerLọc kết quả theo mã xã/phường. Chỉ trả về địa chỉ thuộc xã/phường có mã này. Xem danh sách mã tại đây.
focus.point.latnumberVĩ độ của điểm cần tập trung cần tìm kiếm.
focus.point.lonnumberKinh độ của điểm cần tập trung cần tìm kiếm.

Yêu cầu mẫu: Dịch vụ Forward Geocoding​

Loading...

Phản hồi mẫu: Dịch vụ Forward Geocoding​

{
  "geocoding": {
    "query": {
      "text": "47A Phạm Viết Chánh",
      "size": 1,
      "layers": ["address", "poi"],
      "sources": ["gm"],
      "private": false,
      "lang": {
        "name": "Vietnamese",
        "iso6391": "vi",
        "iso6393": "vie",
        "via": "querystring",
        "defaulted": false
      },
      "querySize": 20,
      "parser": "pelias",
      "parsed_text": {
        "subject": "47A Phạm Viết Chánh"
      }
    }
  },
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [106.683321, 10.766121]
      },
      "properties": {
        "id": "25200a3e-551a-4cb6-9ac9-113c662d94ed",
        "gid": "gm:address:25200a3e-551a-4cb6-9ac9-113c662d94ed",
        "layer": "address",
        "source": "gm",
        "source_id": "25200a3e-551a-4cb6-9ac9-113c662d94ed",
        "name": "47A Đ. Phạm Viết Chánh",
        "confidence": 1,
        "match_type": "exact",
        "accuracy": "point",
        "country": "Việt Nam",
        "region": "Thành phố Hồ Chí Minh",
        "county": "Quận 1",
        "localadmin": "Phường Nguyễn Cư Trinh",
        "plus_code": "7P28QM8M+C8",
        "region_code": "79",
        "county_code": "760",
        "localadmin_code": "26758",
        "locality_code": "26758",
        "locality": "Phường Nguyễn Cư Trinh",
        "address": "47A Phạm Viết Chánh, Phường Nguyễn Cư Trinh, Quận 1, Thành phố Hồ Chí Minh, Việt Nam",
        "types": ["street_address"],
        "address_components": [
          {
            "longText": "47A",
            "shortText": "47A",
            "types": ["street_number"]
          },
          {
            "longText": "Phạm Viết Chánh",
            "shortText": "Phạm Viết Chánh",
            "types": ["route"]
          },
          {
            "longText": "Phường Nguyễn Cư Trinh",
            "shortText": "Nguyễn Cư Trinh",
            "adminCode": "26758",
            "adminLevel": "Phường",
            "types": ["administrative_area_level_3"]
          },
          {
            "longText": "Quận 1",
            "shortText": "1",
            "adminCode": "760",
            "adminLevel": "Quận",
            "types": ["administrative_area_level_2"]
          },
          {
            "longText": "Thành phố Hồ Chí Minh",
            "shortText": "Hồ Chí Minh",
            "adminCode": "79",
            "adminLevel": "Thành phố Trung ương",
            "types": ["administrative_area_level_1"]
          },
          {
            "longText": "",
            "shortText": "",
            "types": ["postal_code"]
          },
          {
            "longText": "Việt Nam",
            "shortText": "VN",
            "types": ["country"]
          }
        ]
      }
    }
  ],
  "bbox": [106.683321, 10.766121, 106.683321, 10.766121],
  "meta": {
    "pagination": {
      "next_page_token": "WzYwLjAyODY0NSwiMjUyMDBhM2UtNTUxYS00Y2I2LTlhYzktMTEzYzY2MmQ5NGVkIl0="
    }
  },
  "licence": "GTEL MAPS"
}