Geocoding API phiên bản 4 cung cấp hai nhóm chức năng chính: tìm kiếm điểm đến để biết các thuộc tính phong phú theo từng khu vực cụ thể và mã hoá địa lý cơ bản (chuyển đổi toạ độ thành địa chỉ). Bạn không biết nên dùng phương thức nào? Xem phần Chọn phương thức mã hoá địa lý.
- Tìm kiếm điểm đến (
SearchDestinations): Truy xuất thông tin chi tiết về điểm đến, bao gồm lối vào toà nhà, điểm điều hướng có thể định tuyến, đường viền toà nhà/khuôn viên, điểm đến phụ và địa danh lân cận. - Mã hoá địa lý (
GeocodeAddress): Chuyển đổi địa chỉ đường phố thành toạ độ vĩ độ và kinh độ để đặt điểm đánh dấu cơ bản hoặc căn giữa bản đồ. - Mã hoá địa lý ngược (
GeocodeLocation): Chuyển đổi toạ độ địa lý thành địa chỉ đường phố mà con người có thể đọc được. - Mã hoá địa lý địa điểm (
GeocodePlace): Tìm địa chỉ và toạ độ được định dạng cho một Mã địa điểm đã biết.
Yêu cầu và phản hồi mẫu
Bạn có thể truy cập vào Geocoding API thông qua giao diện HTTP. Dưới đây là các ví dụ bắt đầu nhanh về Tìm điểm đến, mã hoá địa lý chuyển tiếp và mã hoá địa lý ngược.
Yêu cầu và phản hồi về việc tìm điểm đến (dữ liệu về điểm đến theo từng khu vực cụ thể)
Ví dụ sau đây gửi một yêu cầu HTTP POST đến SearchDestinations cho "1600 Amphitheatre Parkway, Mountain View, CA". Xin lưu ý rằng SearchDestinations yêu cầu tiêu đề X-Goog-FieldMask chỉ định các trường cần trả về:
curl -X POST -d '{ "addressQuery": { "addressQuery": "1600 Amphitheatre Parkway, Mountain View, CA" } }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-FieldMask: destinations.primary.displayName,destinations.primary.formattedAddress,destinations.primary.location,destinations.primary.displayPolygon,destinations.entrances,destinations.navigationPoints,destinations.landmarks' \ -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/destinations"
Dưới đây là phản hồi mẫu của SearchDestinations cho thấy đa giác ranh giới toà nhà, lối vào ưu tiên, điểm đi theo chỉ dẫn và địa danh lân cận:
{ "destinations": [ { "primary": { "displayName": { "text": "Googleplex", "languageCode": "en" }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "location": { "latitude": 37.4220656, "longitude": -122.0840897 }, "displayPolygon": { "type": "Polygon", "coordinates": [ [ [-122.084958, 37.422145], [-122.084112, 37.422610], [-122.083510, 37.421980], [-122.084958, 37.422145] ] ] } }, "entrances": [ { "location": { "latitude": 37.422189, "longitude": -122.084215 }, "tags": ["PREFERRED"] } ], "navigationPoints": [ { "navigationPointToken": "Eg...", "displayName": { "text": "Amphitheatre Pkwy Dropoff", "languageCode": "en" }, "location": { "latitude": 37.421912, "longitude": -122.084301 }, "travelModes": ["DRIVE"], "usages": ["DROPOFF", "PICKUP"] } ], "landmarks": [ { "place": { "displayName": { "text": "Charleston Park", "languageCode": "en" } }, "relationalDescription": { "text": "Adjacent to Charleston Park", "languageCode": "en" }, "straightLineDistanceMeters": 85.4 } ] } ] }
Yêu cầu và phản hồi về mã hoá địa lý (tra cứu vĩ độ/kinh độ)
Ví dụ sau đây yêu cầu vĩ độ và kinh độ của "1600 Amphitheatre Parkway, Mountain View, CA" và chỉ định rằng kết quả đầu ra phải ở định dạng JSON.
curl -H "X-Goog-Api-Key: YOUR_API_KEY" \ "https://geocode.googleapis.com/v4/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"
Bạn có thể kiểm tra điều này bằng cách nhập URL vào trình duyệt web (nhớ thay thế YOUR_API_KEY bằng khoá API thực tế của bạn).
Phản hồi bao gồm vĩ độ và kinh độ của địa chỉ.
Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về cách tạo URL yêu cầu mã hoá địa lý, các tham số có sẵn và cách hiểu phản hồi.
Dưới đây là phản hồi mẫu về việc mã hoá địa lý, ở định dạng JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ", "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ", "location": { "latitude": 37.4438238, "longitude": -122.0869895 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.4424748197085, "longitude": -122.0883384802915 }, "high": { "latitude": 37.445172780291493, "longitude": -122.08564051970852 } }, "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043-1351", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] }, { "longText": "1351", "shortText": "1351", "types": [ "postal_code_suffix" ] } ], "types": [ "premise", "street_address" ] } ] }
Yêu cầu và phản hồi mã hoá địa lý ngược (tra cứu địa chỉ)
Ví dụ sau đây yêu cầu địa chỉ tương ứng với một vĩ độ/kinh độ nhất định ở Brooklyn, NY, Hoa Kỳ. Tham số này chỉ định rằng kết quả phải ở định dạng JSON.
https://geocode.googleapis.com/v4/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEYBạn có thể kiểm tra điều này bằng cách nhập URL vào trình duyệt web (nhớ thay thế "YOUR_API_KEY" bằng khoá API thực tế của bạn). Phản hồi bao gồm một địa chỉ mà con người có thể đọc được cho vị trí vĩ độ và kinh độ.
Xem hướng dẫn dành cho nhà phát triển để biết thêm thông tin về cách tạo URL yêu cầu mã hoá địa lý ngược, các tham số có sẵn và cách hiểu phản hồi.
Dưới đây là phản hồi mẫu về mã hoá địa lý ngược, ở định dạng JSON:
{ "results": [ { "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE", "location": { "latitude": 37.4225657, "longitude": -122.08465439999999 }, "granularity": "ROOFTOP", "viewport": { "low": { "latitude": 37.421214719708509, "longitude": -122.08603273029148 }, "high": { "latitude": 37.423912680291508, "longitude": -122.0833347697085 } }, "bounds": { "low": { "latitude": 37.4225178, "longitude": -122.08484599999998 }, "high": { "latitude": 37.422609600000008, "longitude": -122.0845215 } }, "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "postalAddress": { "regionCode": "US", "languageCode": "en", "postalCode": "94043", "administrativeArea": "CA", "locality": "Mountain View", "addressLines": [ "Google Building 40", "1600 Amphitheatre Pkwy" ] }, "addressComponents": [ { "longText": "Google Building 40", "shortText": "Google Building 40", "types": [ "premise" ], "languageCode": "en" }, { "longText": "1600", "shortText": "1600", "types": [ "street_number" ] }, { "longText": "Amphitheatre Parkway", "shortText": "Amphitheatre Pkwy", "types": [ "route" ], "languageCode": "en" }, { "longText": "Mountain View", "shortText": "Mountain View", "types": [ "locality", "political" ], "languageCode": "en" }, { "longText": "Santa Clara County", "shortText": "Santa Clara County", "types": [ "administrative_area_level_2", "political" ], "languageCode": "en" }, { "longText": "California", "shortText": "CA", "types": [ "administrative_area_level_1", "political" ], "languageCode": "en" }, { "longText": "United States", "shortText": "US", "types": [ "country", "political" ], "languageCode": "en" }, { "longText": "94043", "shortText": "94043", "types": [ "postal_code" ] } ], "types": [ "street_address", "subpremise" ] }, ... Additional results truncated in this example[] ... }
Xác thực, hạn mức, giá và chính sách
Xác thực
Để sử dụng Geocoding API, trước tiên, bạn phải bật API này và lấy thông tin xác thực thích hợp. Để biết thêm thông tin, hãy xem bài viết Bắt đầu sử dụng Google Maps Platform.
Hạn mức và giá
Xem trang mức sử dụng và thanh toán để biết thông tin chi tiết về hạn mức và giá được đặt cho Geocoding API.
Chính sách
Việc sử dụng Geocoding API phải tuân thủ các chính sách về API.