Geocoder

Lớp Geocoder

Lớp google.maps.Geocoder

Một dịch vụ để chuyển đổi giữa địa chỉ và LatLng.

Truy cập bằng cách gọi const {Geocoder} = await google.maps.importLibrary("geocoding"). Xem phần Thư viện trong API Maps JavaScript.
Geocoder
Geocoder()
Thông số:  Không có
Tạo một thực thể mới của Geocoder để gửi yêu cầu mã địa lý đến máy chủ của Google.
geocode
geocode(request[, callback])
Thông số: 
Giá trị trả về:  Promise<GeocoderResponse>
Mã hoá địa lý một yêu cầu.

Giao diện GeocoderRequest

Giao diện google.maps.GeocoderRequest

Thông số kỹ thuật cho yêu cầu mã hoá địa lý sẽ được gửi đến Geocoder.
address optional
Loại:  string optional
Địa chỉ để mã hoá địa lý. Bạn chỉ được cung cấp một trong các thuộc tính address, location và placeId.
bounds optional
LatLngBounds để tìm kiếm. Không bắt buộc.
componentRestrictions optional
Thành phần được dùng để giới hạn kết quả trong một khu vực cụ thể. Một bộ lọc bao gồm một hoặc nhiều trong số các loại sau: route, locality, administrativeArea, postalCode, country. Hệ thống sẽ chỉ trả về những kết quả khớp với tất cả bộ lọc. Giá trị bộ lọc hỗ trợ các phương thức sửa lỗi chính tả và so khớp một phần giống như các yêu cầu mã hoá địa lý khác. Không bắt buộc.
language optional
Loại:  string optional
Giá trị nhận dạng ngôn ngữ cho ngôn ngữ mà kết quả sẽ được trả về (khi có thể). Xem danh sách ngôn ngữ được hỗ trợ.
location optional
Loại:  LatLng|LatLngLiteral optional
LatLng (hoặc LatLngLiteral) cần tìm. Bộ mã hoá địa lý thực hiện mã hoá địa lý ngược. Hãy xem phần Đảo ngược mã địa lý để biết thêm thông tin. Bạn chỉ được cung cấp một trong các thuộc tính address, location và placeId.
placeId optional
Loại:  string optional
Mã địa điểm liên kết với vị trí. Mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Tìm hiểu thêm về mã địa điểm trong hướng dẫn dành cho nhà phát triển về API Địa điểm. Bộ mã hoá địa lý thực hiện mã hoá địa lý ngược. Hãy xem phần Biên dịch địa lý ngược để biết thêm thông tin. Bạn chỉ được cung cấp một trong các thuộc tính address, location và placeId.
region optional
Loại:  string optional
Mã quốc gia dùng để thiên lệch kết quả tìm kiếm, được chỉ định dưới dạng thẻ con khu vực Unicode / giá trị nhận dạng CLDR gồm hai ký tự (không phải số). Không bắt buộc. Xem Thông tin chi tiết về phạm vi của Nền tảng Google Maps để biết các khu vực được hỗ trợ.

Giao diện GeocoderComponentRestrictions

Giao diện google.maps.GeocoderComponentRestrictions

GeocoderComponentRestrictions đại diện cho một nhóm bộ lọc phân giải đến một khu vực cụ thể. Để biết thông tin chi tiết về cách hoạt động của tính năng này, hãy xem phần Lọc thành phần mã hoá địa lý.
administrativeArea optional
Loại:  string optional
Khớp với tất cả administrative_area levels. Không bắt buộc.
country optional
Loại:  string optional
Khớp với tên quốc gia hoặc mã quốc gia gồm hai chữ cái theo ISO 3166-1. Không bắt buộc.
locality optional
Loại:  string optional
So khớp với cả loại locality và sublocality. Không bắt buộc.
postalCode optional
Loại:  string optional
Khớp với postal_code và postal_code_prefix. Không bắt buộc.
route optional
Loại:  string optional
Khớp với tên dài hoặc tên ngắn của route. Không bắt buộc.

Hằng số GeocoderStatus

Hằng số google.maps.GeocoderStatus

Trạng thái do Geocoder trả về khi hoàn tất lệnh gọi đến geocode(). Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. Ví dụ: 'OK' hoặc google.maps.GeocoderStatus.OK.

Truy cập bằng cách gọi const {GeocoderStatus} = await google.maps.importLibrary("geocoding"). Xem phần Thư viện trong API Maps JavaScript.
ERROR Đã xảy ra sự cố khi kết nối với các máy chủ của Google.
INVALID_REQUEST GeocoderRequest này không hợp lệ.
OK Phản hồi chứa GeocoderResponse hợp lệ.
OVER_QUERY_LIMIT Trang web đã vượt quá giới hạn yêu cầu trong một khoảng thời gian quá ngắn.
REQUEST_DENIED Trang web không được phép sử dụng trình dịch địa lý.
UNKNOWN_ERROR Không thể xử lý yêu cầu mã hoá địa lý do lỗi máy chủ. Yêu cầu có thể thành công nếu bạn thử lại.
ZERO_RESULTS Không tìm thấy kết quả nào cho GeocoderRequest này.

Giao diện GeocoderResponse

Giao diện google.maps.GeocoderResponse

Phản hồi của Trình dịch địa lý do Geocoder trả về, chứa danh sách GeocoderResult.
results
Danh sách GeocoderResult.

Giao diện GeocoderResult

Giao diện google.maps.GeocoderResult

Một kết quả của trình dịch địa lý được truy xuất từ máy chủ mã địa lý. Yêu cầu mã địa lý có thể trả về nhiều đối tượng kết quả. Xin lưu ý rằng mặc dù kết quả này "giống như JSON", nhưng không phải là JSON nghiêm ngặt vì kết quả này gián tiếp bao gồm một đối tượng LatLng.
address_components
Một mảng GeocoderAddressComponent
formatted_address
Loại:  string
Chuỗi ký tự chứa địa chỉ mà con người đọc được của vị trí này.
geometry
Một đối tượng GeocoderGeometry
place_id
Loại:  string
Mã địa điểm liên kết với vị trí. Mã địa điểm giúp xác định riêng một địa điểm trong cơ sở dữ liệu của Google Địa điểm và trên Google Maps. Tìm hiểu thêm về Mã địa điểm trong hướng dẫn dành cho nhà phát triển về API Địa điểm.
types
Loại:  Array<string>
Một mảng chuỗi biểu thị loại của phần tử được mã hoá địa lý được trả về. Để biết danh sách các chuỗi có thể có, hãy tham khảo phần Các loại thành phần địa chỉ trong Hướng dẫn dành cho nhà phát triển.
partial_match optional
Loại:  boolean optional
Liệu trình chuyển đổi địa lý có trả về kết quả khớp chính xác cho yêu cầu ban đầu hay không, mặc dù có thể khớp một phần địa chỉ được yêu cầu. Nếu khớp chính xác, giá trị sẽ là undefined.
plus_code optional
Loại:  PlacePlusCode optional
Mã plus liên kết với vị trí.
postcode_localities optional
Loại:  Array<string> optional
Một mảng các chuỗi biểu thị tất cả địa phương có trong một mã bưu chính. Thuộc tính này chỉ xuất hiện khi kết quả là mã bưu chính chứa nhiều địa phương.

Giao diện GeocoderAddressComponent

Giao diện google.maps.GeocoderAddressComponent

Một thành phần địa chỉ trong GeocoderResult. Một địa chỉ đầy đủ có thể bao gồm nhiều thành phần địa chỉ.
long_name
Loại:  string
Toàn văn thành phần địa chỉ
short_name
Loại:  string
Văn bản ngắn, viết tắt của thành phần địa chỉ đã cho
types
Loại:  Array<string>
Một mảng các chuỗi biểu thị loại thành phần địa chỉ này. Bạn có thể xem danh sách các loại hợp lệ tại đây

Giao diện GeocoderGeometry

Giao diện google.maps.GeocoderGeometry

Thông tin hình học về GeocoderResult này
location
Loại:  LatLng
Toạ độ vĩ độ/kinh độ của kết quả này
location_type
Loại vị trí được trả về trong location
viewport
Loại:  LatLngBounds
Các giới hạn của khung nhìn được đề xuất để hiển thị GeocoderResult này
bounds optional
Loại:  LatLngBounds optional
Giới hạn chính xác của GeocoderResult này (nếu có)

Hằng số GeocoderLocationType

Hằng số google.maps.GeocoderLocationType

Mô tả loại vị trí được trả về từ mã địa lý. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. Ví dụ: 'ROOFTOP' hoặc google.maps.GeocoderLocationType.ROOFTOP.

Truy cập bằng cách gọi const {GeocoderLocationType} = await google.maps.importLibrary("geocoding"). Xem phần Thư viện trong API Maps JavaScript.
APPROXIMATE Kết quả trả về là kết quả ước tính.
GEOMETRIC_CENTER Kết quả trả về là tâm hình học của một kết quả, chẳng hạn như đường (ví dụ: đường phố) hoặc đa giác (khu vực).
RANGE_INTERPOLATED Kết quả trả về phản ánh giá trị gần đúng (thường là trên đường) được nội suy giữa hai điểm chính xác (chẳng hạn như giao lộ). Kết quả nội suy thường được trả về khi không có mã địa lý trên mái nhà cho một địa chỉ đường phố.
ROOFTOP Kết quả trả về phản ánh một mã địa lý chính xác.