Geocoder | Maps JavaScript API | Google for Developers (original) (raw)
Geocoder
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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.
| Hàm dựng | |
|---|---|
| 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. |
| Phương thức | |
|---|---|
| geocode | geocode(request[, callback]) Thông số: request: GeocoderRequest callback: function(Array<GeocoderResult> optional, GeocoderStatus): void optional 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.
| Thuộc tính | |
|---|---|
| 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 | Loại: LatLngBounds|LatLngBoundsLiteral optional LatLngBounds để tìm kiếm. Không bắt buộc. |
| componentRestrictions optional | Loại: GeocoderComponentRestrictions 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. |
| extraComputations optional | Loại: Array<ExtraGeocodeComputation> optional Danh sách các phép tính bổ sung có thể được dùng để hoàn tất yêu cầu. Lưu ý: Các phép tính bổ sung này có thể trả về các trường bổ sung trong phản hồi. |
| fulfillOnZeroResults optional | Loại: boolean optional Thực hiện lời hứa về trạng thái ZERO_RESULT trong phản hồi. Bạn có thể muốn làm như vậy vì ngay cả khi không có kết quả mã hoá địa lý nào, vẫn có thể có các trường cấp phản hồi bổ sung được trả về. |
| 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ý.
| Thuộc tính | |
|---|---|
| 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ố google.maps.ExtraGeocodeComputation
Các phép tính bổ sung cần thực hiện trong khi hoàn tất yêu cầu mã hoá địa lý.
Truy cập bằng cách gọi const {ExtraGeocodeComputation} = await google.maps.importLibrary("geocoding"). Xem phần Thư viện trong API Maps JavaScript.
| Hằng số | |
|---|---|
| ADDRESS_DESCRIPTORS | Tạo một chỉ số mô tả địa chỉ. |
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.
| Hằng số | |
|---|---|
| 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 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.
| Thuộc tính | |
|---|---|
| address_components | Loại: Array<GeocoderAddressComponent> 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 | Loại: GeocoderGeometry 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 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. |
| address_descriptor optional | Loại: AddressDescriptor optional Nội dung mô tả có liên quan về vị trí liên kết với mã địa lý này. Bao gồm một tập hợp các địa danh lân cận được xếp hạng và các khu vực chứa vị trí mục tiêu. Giá trị này sẽ chỉ được điền cho các yêu cầu tra cứu mã địa điểm và địa chỉ chuyển tiếp, chỉ khi ExtraGeocodeComputation.ADDRESS_DESCRIPTORS được bật và chỉ cho một số địa điểm được bản địa hoá. |
| 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 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 AddressDescriptor
Giao diện google.maps.AddressDescriptor
Nội dung mô tả quan hệ về một vị trí. Bao gồm một tập hợp các địa danh lân cận được xếp hạng và các khu vực chứa vị trí mục tiêu.
| Thuộc tính | |
|---|---|
| areas | Loại: Array<Area> Danh sách được xếp hạng gồm các khu vực chứa hoặc liền kề. Những khu vực hữu ích nhất (nhận dạng được và chính xác) được xếp hạng đầu tiên. |
| landmarks | Loại: Array<Landmark> Danh sách địa danh lân cận được xếp hạng. Những địa danh hữu ích nhất (nhận dạng được và ở gần) được xếp hạng đầu tiên. |
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ỉ.
| Thuộc tính | |
|---|---|
| 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 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
| Thuộc tính | |
|---|---|
| location | Loại: LatLng Toạ độ vĩ độ/kinh độ của kết quả này |
| location_type | Loại: GeocoderLocationType 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.
| Hằng số | |
|---|---|
| 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. |
Giao diện Điểm mốc
Giao diện google.maps.Landmark
Một địa điểm đại diện cho điểm tham chiếu cho địa chỉ.
| Thuộc tính | |
|---|---|
| display_name | Loại: string Tên của địa danh. |
| display_name_language_code | Loại: string Ngôn ngữ của tên địa danh. |
| place_id | Loại: string Mã địa điểm của cơ sở lưu trú cơ bản đóng vai trò là địa danh. Có thể dùng để phân giải thêm thông tin về địa danh thông qua tính năng Chi tiết về địa điểm hoặc Tìm kiếm theo mã địa điểm. |
| spatial_relationship | Loại: SpatialRelationship Xác định mối quan hệ không gian giữa vị trí mục tiêu và điểm đánh dấu. |
| straight_line_distance_meters | Loại: number Khoảng cách theo đường thẳng giữa vị trí mục tiêu và điểm đánh dấu. |
| types | Loại: Array Một hoặc nhiều giá trị cho biết loại kết quả được trả về. Vui lòng xem phần Loại để biết thêm thông tin chi tiết. |
| travel_distance_meters optional | Loại: number optional Khoảng cách di chuyển dọc theo mạng lưới đường bộ giữa vị trí mục tiêu và địa điểm nổi bật. Trường này có thể không được điền nếu địa điểm yêu thích bị ngắt kết nối với phần mạng lưới đường mà mục tiêu gần nhất hoặc nếu vị trí mục tiêu thực sự không được coi là nằm trên mạng lưới đường. |
Giao diện Vùng
Giao diện google.maps.Area
Một địa điểm là một khu vực nhỏ, chẳng hạn như một khu dân cư, khu vực phụ hoặc khu phức hợp lớn chứa vị trí mục tiêu.
| Thuộc tính | |
|---|---|
| containment | Loại: Containment Xác định mối quan hệ không gian giữa vị trí mục tiêu và khu vực. |
| display_name | Loại: string Tên của khu vực. |
| display_name_language_code | Loại: string Ngôn ngữ của tên khu vực. |
| place_id | Loại: string Mã địa điểm của khu vực cơ bản. Có thể dùng để phân giải thêm thông tin về khu vực thông qua tính năng Chi tiết về địa điểm hoặc Tìm kiếm theo mã địa điểm. |
Hằng số Containment
Hằng số google.maps.Containment
Một enum đại diện cho mối quan hệ không gian giữa khu vực và vị trí mục tiêu.
Truy cập bằng cách gọi const {Containment} = await google.maps.importLibrary("geocoding"). Xem phần Thư viện trong API Maps JavaScript.
| Hằng số | |
|---|---|
| NEAR | Vị trí mục tiêu nằm ngoài khu vực, nhưng ở gần. |
| OUTSKIRTS | Vị trí mục tiêu nằm trong vùng, gần cạnh. |
| WITHIN | Vị trí mục tiêu nằm trong khu vực, gần trung tâm. |
Hằng số SpatialRelationship
Hằng số google.maps.SpatialRelationship
Một enum đại diện cho mối quan hệ trong không gian giữa điểm đánh dấu và mục tiêu.
Truy cập bằng cách gọi const {SpatialRelationship} = await google.maps.importLibrary("geocoding"). Xem phần Thư viện trong API Maps JavaScript.
| Hằng số | |
|---|---|
| ACROSS_THE_ROAD | Mục tiêu nằm ngay đối diện với điểm mốc ở phía bên kia đường. |
| AROUND_THE_CORNER | Không nằm trên cùng tuyến đường với địa điểm yêu thích nhưng chỉ cách một ngã rẽ. |
| BEHIND | Gần cấu trúc của địa danh nhưng cách xa điểm truy cập của địa danh đó. |
| BESIDE | Mục tiêu nằm ngay cạnh điểm đánh dấu. |
| DOWN_THE_ROAD | Trên cùng một tuyến đường với địa điểm yêu thích, nhưng không phải bên cạnh hoặc đối diện. |
| NEAR | Đây là mối quan hệ mặc định khi không có mối quan hệ cụ thể nào khác áp dụng ở bên dưới. |
| WITHIN | Điểm đánh dấu có hình học không gian và mục tiêu nằm trong giới hạn của điểm đánh dấu. |