Geocoding | eKAPI Docs

Dịch vụ tìm kiếm vị trí, địa chỉ:

Tìm vị trí theo địa chỉ
Tìm địa chỉ theo vị trí

Tìm vị trí từ địa chỉ

Mô tả: Dịch vụ cung cấp thông tin vị trí từ địa chỉ bất kỳ

URL: /v1/place/geocode/forward?address={address}&bounds={bounds}&language={language}&region={region}&components={components}

Method: GET

Parameters:

Tham số	Mô tả	Giá trị
`address`	Địa chỉ cần xác định	Ví dụ: `Số 2, Duy Tân, Dịch Vọng, Cầu Giấy, Hà Nội`
`bounds`	Giới hạn vùng bao tìm kiếm	Ví dụ `34.172684,-118.604794
`language`	Ngôn ngữ trả về kết quả	Ví dụ `vi`
`region`	Mã vùng, được chỉ định dưới dạng giá trị hai ký, xem tại đây	Ví dụ `vn`
`components`	Xem thêm tại đây	`country:ES`

Ví dụ Request:

$ curl "https://api.ekgis.vn/v1/place/geocode/forward?address=Số 2, Duy Tân, Dịch Vọng, Cầu Giấy, Hà Nội&api_key={YOUR_API_KEY}"

Response:

Xem chi tiết mô tả kết quả trả về tại đây

Ví dụ dữ liệu trả về dạng JSON:

{
"results" : [
{
"address_components" : [
{
"long_name" : "2",
"short_name" : "2",
"types" : [ "street_number" ]
},
{
"long_name" : "Phố Duy Tân",
"short_name" : "Phố Duy Tân",
"types" : [ "route" ]
},
{
"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" ]
},
{
"long_name" : "Vietnam",
"short_name" : "VN",
"types" : [ "country", "political" ]
}
],
"formatted_address" : "2 Phố Duy Tân, Dịch Vọng Hậu, Cầu Giấy, Hà Nội, Vietnam",
"geometry" : {
"location" : {
"lat" : 21.0304469,
"lng" : 105.7871434
},
"location_type" : "RANGE_INTERPOLATED",
"viewport" : {
"northeast" : {
"lat" : 21.0317958802915,
"lng" : 105.7884923802915
},
"southwest" : {
"lat" : 21.02909791970849,
"lng" : 105.7857944197085
}
}
},
"place_id" : "EkcyIFBo4buRIER1eSBUw6JuLCBE4buLY2ggVuG7jW5nIEjhuq11LCBD4bqndSBHaeG6pXksIEjDoCBO4buZaSwgVmlldG5hbSIaEhgKFAoSCWtCOwRMqzUxEVm3hCU2ELqxEAI",
"types" : [ "street_address" ]
}
],
"status" : "OK"
}

Tìm địa chỉ tốt nhất từ vị trí

Mô tả: Tìm địa điểm tốt nhất bao gồm số nhà, tên đường, ... từ thông tin vị trí long,lat

URL: /v1/place/geocode/reverse/address?latlng={latlng}

Method: GET

Parameters:

Tham số	Mô tả	Giá trị
`latlng`	Điểm cần xác định, định dạng `lat,long`	Ví dụ: `21.0177474,105.7805817`

Ví dụ Request:

$ curl "https://api.ekgis.vn/v1/place/geocode/reverse/address?latlng=21.0177474,105.7805817&api_key={YOUR_API_KEY}"

Response:

Trả về kết quả địa điểm cần tìm

Ví dụ dữ liệu trả về dạng JSON:

{
results: "Tòa nhà HH4, Mễ Trì, Từ Liêm, Hà Nội, Việt Nam"
}

Tìm địa chỉ đơn giản nhất từ vị trí

Mô tả: Tương tự dịch vụ Tìm địa chỉ tốt nhất từ vị trí tìm địa điểm đơn giản nhất bao gồm số nhà, tên đường, ... từ thông tin vị trí long,lat

URL: /v1/place/geocode/reverse/text?latlng={latlng}

Method: GET

Parameters:

Tham số	Mô tả	Giá trị
`latlng`	Điểm cần xác định, định dạng `lat,long`	Ví dụ: `21.0177474,105.7805817`

Ví dụ Request:

$ curl "https://api.ekgis.vn/v1/place/geocode/reverse/text?latlng=21.0177474,105.7805817&api_key={YOUR_API_KEY}"

Response:

Trả về kết quả địa điểm là mảng cần tìm

Ví dụ dữ liệu trả về dạng JSON:

{
results: [
"Tòa nhà HH4, Mễ Trì, Từ Liêm, Hà Nội, Việt Nam"
]
}

Tìm địa chỉ chi tiết nhất

Mô tả: Tìm địa điểm chi tiết nhất bao gồm thông tin tuyến đường, vị trí, phường/xã, quận/huyện, tỉnh/thành phố,... từ thông tin vị trí long,lat

URL: /v1/place/geocode/reverse/roadname?latlng={latlng}

Method: GET

Parameters:

Tham số	Mô tả	Giá trị
`latlng`	Điểm cần xác định, định dạng `lat,long`	Ví dụ: `21.0177474,105.7805817`

Ví dụ Request:

$ curl "https://api.ekgis.vn/v1/place/geocode/reverse/roadname?latlng=21.0177474,105.7805817&api_key={YOUR_API_KEY}"

Response:

Trả về kết quả địa điểm cần tìm

Ví dụ dữ liệu trả về dạng JSON:

{
	"results": [
		{
			"address_components": [
				{
					"long_name": "phường Mỹ Đình 1",
					"short_name": "phường Mỹ Đình 1",
					"types": [
						"political",
						"sublocality",
						"sublocality_level_1"
					]
				},
				{
					"long_name": "quận Nam Từ Liêm",
					"short_name": "quận Nam Từ Liêm",
					"types": [
						"administrative_area_level_2",
						"political"
					]
				},
				{
					"long_name": "Hà Nội",
					"short_name": "Hà Nội",
					"types": [
						"administrative_area_level_1",
						"political"
					]
				},
				{
					"long_name": "Việt Nam",
					"short_name": "VN",
					"types": [
						"country",
						"political"
					]
				}
			],
			"formatted_address": "phường Mỹ Đình 1,quận Nam Từ Liêm,Hà Nội, Việt Nam",
			"geometry": {
				"location": {
					"lat": 21.0177474,
					"lng": 105.7805817
				},
				"location_type": "ROOFTOP",
				"viewport": {}
			},
			"place_id": "",
			"types": [
				"street_address"
			]
		}
	],
	"status": "OK"
}