Địa danh tự nhiên và điểm dân cư
FreeKhoảng 55.000 địa danh có toạ độ: sông suối, núi đồi, đèo, đảo, hồ, vịnh, mũi, kênh, thác, hang động, ga, thôn/ấp/làng — tên tiếng Việt, loại địa danh, tỉnh mới, độ cao, dân số (nếu có), liên kết Wikidata. Nguồn: GeoNames, giấy phép CC BY 4.0.
Endpoint
| Endpoint | Mô tả |
|---|---|
| GET /v1/geographic-places | Tìm kiếm, lọc, phân trang |
| GET /v1/geographic-places/{id} | Chi tiết một bản ghi (toàn bộ trường) |
bash
curl "https://api.dulieuphapluat.vn/v1/geographic-places?q=từ khoá&per_page=10" \
-H "Authorization: Bearer dlpl_live_xxxxxxxxxxxxxxxxxxxxxxxx"Tham số và trường dữ liệu
Tham số lọc
| Tham số | Kiểu |
|---|---|
| q | Từ khoá tìm trong: name, name_ascii, name_vi_alternate |
| feature_class | string |
| feature_code | string |
| province_code | string |
| wikidata_id | string |
| page, per_page | Phân trang |
Cần ít nhất một trong: q, feature_code, province_code, wikidata_id
Trường dữ liệu
| Trường | Kiểu | Gói |
|---|---|---|
| id | id | Free |
| name | string | Free |
| name_ascii* | string | Free |
| name_vi_alternate* | string | Free |
| feature_class* | string | Free |
| feature_code | string | Free |
| feature_label | string | Free |
| latitude | float | Free |
| longitude | float | Free |
| province_code | string | Free |
| elevation_m | int | Free |
| population* | int | Free |
| wikidata_id* | string | Free |
| geonames_id* | int | Free |
* chỉ trả ở endpoint chi tiết.