POI Search | Maps APIs | eKMap Platform

Mô tả: Tìm kiếm thông tin địa điểm nhận vào có thể là phân loại, bán kính, vùng bao bất kỳ hoặc tên địa điểm

URL: /poi/nearbysearch

Method: GET

Parameters:

Tham số	Mô tả	Giá trị
`location`	Vị trí cần truy vấn, giá trị theo dạng `kinh độ,vĩ độ` (longitude,latitude). Tham số được áp dụng khi có tham số `radius`	Ví dụ: `105.786735,21.027758`
`radius`	Bán kính quanh vị trí `location`, đơn vị tính bằng mét (meters). Nếu tham số này có giá trị thì tham số `location` cũng phải có giá trị.	Ví dụ: `1000`
`polygon`	Nếu không muốn tìm theo `radius`, có thể tìm theo vùng bao bất kỳ với tham số `polygon`. Giá trị tham số này định dạng WKT ở hệ quy chiếu WGS84 (4326). Tham số `radius` được ưu tiên sử dụng nếu có.	Ví dụ `POLYGON((40 40, 20 45, 45 30, 40 40))`
`class_id`	Truy vấn theo phân loại. Xem danh sách các loại hỗ trợ	Ví dụ `park`
`subclass_id`	Truy vấn theo phân loại chi tiết. Xem danh sách các loại hỗ trợ	Ví dụ `park`
`name`	Tìm kiếm theo nhưng đối tượng phù hợp chứa `name` phù hợp	Ví dụ `Trường học`
`skipCount`	Dùng để phân trang dữ liệu, bản ghi bắt đầu lấy từ `skipCount`. Mặc định `0`	Ví dụ `0`
`maxResultCount`	Số lượng bản ghi trong một lần truy vấn, mặc định `25`	Ví dụ `25`

Ví dụ Request:

$ curl "https://api.ekgis.vn/poi/nearbysearch?location=105.786735,21.027758&radius=1000&name=C%C3%B4ng%20vi%C3%AAn&api_key={YOUR_API_KEY}"

Response:

Thông tin trả về danh sách các địa điểm đối tượng bao gồm: Vị trí, địa chỉ, tên, thông tin đơn vị hành chính, ...

Định dạng dữ liệu trả về dạng JSON

Ví dụ:

{
	"status": "OK",
	"totalCount": 1,
	"results": [
		{
			"id": "BQ04",
			"class": {
				"class_id": "park",
				"vie_class": "Công viên",
				"eng_class": "Park"
			},
			"subclass": {
				"subclass_id": "park",
				"vie_subclass": "Công viên",
				"eng_subclass": "Park"
			},
			"name": "Công viên Cầu Giấy",
			"geometry": {
				"location": {
					"lng": 105.791843297921,
					"lat": 21.0306369614075
				}
			},
			"formatted_address": "phố Thành Thái, phường Dịch Vọng",
			"address_components": [
				{
					"long_name": "Cầu Giấy",
					"short_name": "Cầu Giấy",
					"types": [
						"administrative_area_level_2",
						"political"
					]
				},
				{
					"long_name": "Hà Nội",
					"short_name": "Hà Nội",
					"types": [
						"administrative_area_level_1",
						"political"
					]
				}
			],
			"status": null,
			"planning_info": null,
			"source": "Khu chức năng",
			"description": null
		}
	]
}