Tra cứu các khu vực địa lý chính trị cho một địa chỉ duy nhất. Thử ngay.
Yêu cầu
Yêu cầu HTTP
GET https://www.googleapis.com/civicinfo/v2/divisionsByAddress
Thông số
Tên thông số | Giá trị | Mô tả |
---|---|---|
Tham số truy vấn không bắt buộc | ||
address |
string |
Địa chỉ cần tra cứu. |
Nội dung yêu cầu
Đừng cung cấp nội dung yêu cầu bằng phương thức này.
Phản hồi
Nếu thành công, phương thức này sẽ trả về một phần nội dung phản hồi có cấu trúc sau:
{ "kind": "civicinfo#divisionsByAddressResponse", "normalizedInput": { "locationName": string, "line1": string, "line2": string, "line3": string, "city": string, "state": string, "zip": string, }, "divisions": { key: { "name": string, "alsoKnownAs": [ string ], }, }
Tên tài sản | Giá trị | Mô tả | Ghi chú |
---|---|---|---|
kind |
string |
Xác định loại tài nguyên. Giá trị: chuỗi cố định |
|
normalizedInput |
nested object |
Phiên bản chuẩn hoá của địa chỉ được yêu cầu. | |
normalizedInput.locationName |
string |
Tên của vị trí. | |
normalizedInput.line1 |
string |
Tên đường và số nhà của địa chỉ. | |
normalizedInput.line2 |
string |
Dòng thứ hai của địa chỉ, nếu cần. | |
normalizedInput.line3 |
string |
Dòng thứ ba của địa chỉ, nếu cần. | |
normalizedInput.city |
string |
Thành phố hoặc thị trấn của địa chỉ. | |
normalizedInput.state |
string |
Tên viết tắt gồm hai chữ cái của tiểu bang Hoa Kỳ trong địa chỉ. | |
normalizedInput.zip |
string |
Mã bưu chính của địa chỉ tại Hoa Kỳ. | |
divisions |
object |
Phân khu địa lý chính trị chứa địa chỉ được yêu cầu. | |
divisions.(key) |
nested object |
Mã nhận dạng Dữ liệu công dân mở (OCD ID) duy nhất của bộ phận. | |
divisions.(key).alsoKnownAs[] |
list |
Mọi mã OCD hợp lệ khác tham chiếu đến cùng một bộ phận. Vì mã OCD dễ đọc và dễ dự đoán, nên đôi khi có một số giá trị nhận dạng cho một bộ phận. Các giá trị nhận dạng này được xác định là tương đương với nhau và một giá trị luôn được chỉ định là giá trị nhận dạng chính. Giá trị nhận dạng chính được trả về trong mã nhận dạng OCD và mọi giá trị nhận dạng hợp lệ tương đương khác sẽ được trả về trong danh sách. Ví dụ: nếu mã OCD của bộ phận sau là |
|
divisions.(key).name |
string |
Tên của bộ phận. |