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 Thư viện trong Maps JavaScript API.
Geocoder
Geocoder()
Tham số:  Không có
Tạo một phiên bản mới của Geocoder để gửi yêu cầu mã hoá địa lý đến các máy chủ của Google.
geocode
geocode(request[, callback])
Tham số: 
Giá trị trả về:  Promise<GeocoderResponse>
Mã hoá địa lý một yêu cầu.

Giao diện GeocoderRequest

google.maps.GeocoderRequestgiao diện

Quy cách cho yêu cầu mã hoá địa lý sẽ được gửi đến Geocoder.
address optional
Loại:  string optional
Địa chỉ cần mã hoá địa lý. Bạn phải cung cấp một và chỉ một trong số address, location và placeId.
bounds optional
LatLngBounds mà trong đó cần tìm kiếm. Không bắt buộc.
componentRestrictions optional
Các thành phần được dùng để giới hạn kết quả trong một khu vực cụ thể. Bộ lọc bao gồm một hoặc nhiều thành phần sau: route, locality, administrativeArea, postalCode, country. Hệ thống sẽ chỉ trả về những kết quả phù hợp với tất cả bộ lọc. Cá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.
BetaextraComputations 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 ý: Những 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. Điều này có thể là do ngay cả khi không có kết quả mã hoá địa lý, 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ề (nếu có thể). Xem danh sách ngôn ngữ được hỗ trợ.
location optional
Loại:  LatLng|LatLngLiteral optional
LatLng (hoặc LatLngLiteral) mà bạn muốn tìm kiếm. Bộ mã hoá địa lý thực hiện một quy trình mã hoá địa lý ngược. Hãy xem phần Geocoding ngược để biết thêm thông tin. Bạn phải cung cấp một và chỉ một trong số address, location và placeId.
placeId optional
Loại:  string optional
Mã địa điểm được 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 Places API. Bộ mã hoá địa lý thực hiện một quy trình mã hoá địa lý ngược. Hãy xem phần Địa lý mã hoá ngược để biết thêm thông tin. Bạn phải cung cấp một và chỉ một trong số address, location và placeId.
region optional
Loại:  string optional
Mã quốc gia dùng để điều chỉnh kết quả tìm kiếm, được chỉ định là mã nhận dạng CLDR / thẻ phụ khu vực Unicode gồm 2 ký tự (không phải là số). Không bắt buộc. Hãy 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

google.maps.GeocoderComponentRestrictionsgiao diện

GeocoderComponentRestrictions đại diện cho một nhóm bộ lọc phân giải thành 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
So 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
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
Trùng khớp với tên dài hoặc tên ngắn của một route. Không bắt buộc.

Hằng số ExtraGeocodeComputation

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 Thư viện trong Maps JavaScript API.
ADDRESS_DESCRIPTORS Tạo một giá trị 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 giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. 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 Thư viện trong Maps JavaScript API.
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 một 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 mã hoá địa lý.
UNKNOWN_ERROR Không xử lý được 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

google.maps.GeocoderResponsegiao diện

Phản hồi Geocoder do Geocoder trả về, chứa danh sách GeocoderResult.
results
Danh sách các GeocoderResult.
Betaaddress_descriptor optional
Loại:  AddressDescriptor optional
Nội dung mô tả quan hệ về một vị trí. Bao gồm một tập hợp được xếp hạng gồm các địa danh lân cận và các khu vực chứa vị trí mục tiêu. Tham số này chỉ được điền cho các yêu cầu mã hoá địa lý ngược và chỉ khi ExtraGeocodeComputation.ADDRESS_DESCRIPTORS được bật.
plus_code optional
Loại:  PlacePlusCode optional
Plus code liên kết với vị trí.

Giao diện GeocoderResult

google.maps.GeocoderResultgiao diện

Một kết quả duy nhất của trình mã hoá địa lý được truy xuất từ máy chủ mã hoá địa lý. Một yêu cầu mã hoá đị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 có "dạng JSON", nhưng không phải là JSON theo đúng nghĩa, 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
Một 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 được 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 Places API.
types
Loại:  Array<string>
Một mảng gồm các chuỗi biểu thị loại phần tử được trả về đã được mã hoá địa lý. Để 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.
Betaaddress_descriptor optional
Loại:  AddressDescriptor optional
Nội dung mô tả mối quan hệ của vị trí liên kết với mã địa lý này. Bao gồm một tập hợp được xếp hạng gồm các địa danh lân cận và các khu vực chứa vị trí mục tiêu. Tham số này sẽ chỉ được điền sẵn cho các yêu cầu tra cứu mã địa lý xuôi và mã địa điểm, chỉ khi bạn bật ExtraGeocodeComputation.ADDRESS_DESCRIPTORS và chỉ dành cho một số địa điểm được bản địa hoá.
partial_match optional
Loại:  boolean optional
Cho dù trình mã hoá địa lý không trả về kết quả khớp chính xác cho yêu cầu ban đầu, nhưng vẫn có thể khớp một phần của địa chỉ được yêu cầu. Nếu là kết quả trùng khớp hoàn toàn, giá trị sẽ là undefined.
plus_code optional
Loại:  PlacePlusCode optional
Plus code liên kết với vị trí.
postcode_localities optional
Loại:  Array<string> optional
Một mảng gồm các chuỗi biểu thị tất cả các địa điểm có trong một mã bưu chính. Tham số này chỉ xuất hiện khi kết quả là một mã bưu chính chứa nhiều địa điểm.

Giao diện AddressDescriptor

google.maps.AddressDescriptorgiao diện

Nội dung mô tả quan hệ về một vị trí. Bao gồm một tập hợp được xếp hạng gồm các địa danh lân cận và các khu vực chứa vị trí mục tiêu.
areas
Loại:  Array<Area>
Danh sách xếp hạng các khu vực chứa hoặc lân cận. Những khu vực hữu ích nhất (dễ nhận biết và chính xác) được xếp hạng đầu tiên.
landmarks
Loại:  Array<Landmark>
Danh sách được xếp hạng các địa danh lân cận. Những địa danh hữu ích nhất (dễ nhận biết và ở gần) sẽ được xếp hạng đầu tiên.

Giao diện GeocoderAddressComponent

google.maps.GeocoderAddressComponentgiao diện

Một thành phần địa chỉ duy nhất 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 nội dung của thành phần địa chỉ
short_name
Loại:  string
Văn bản ngắn gọ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

google.maps.GeocoderGeometrygiao diện

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
Ranh giới của khung nhìn được đề xuất để hiển thị GeocoderResult này
bounds optional
Loại:  LatLngBounds optional
Ranh giới 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ột mã địa lý. Chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. 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 Thư viện trong Maps JavaScript API.
APPROXIMATE Kết quả trả về là kết quả ước chừng.
GEOMETRIC_CENTER Kết quả trả về là tâm hình học của một kết quả như đường thẳng (ví dụ: đường phố) hoặc đa giác (khu vực).
RANGE_INTERPOLATED Kết quả trả về phản ánh một giá trị gần đúng (thường là trên đường) được suy đoán giữa hai điểm chính xác (chẳng hạn như giao lộ). Kết quả được 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

google.maps.Landmarkgiao diện

Một địa điểm đại diện cho điểm tham chiếu của địa chỉ.
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ở 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 Place Details hoặc Place Id Lookup.
spatial_relationship
Xác định mối quan hệ không gian giữa vị trí mục tiêu và địa danh.
straight_line_distance_meters
Loại:  number
Khoảng cách theo đường thẳng giữa vị trí mục tiêu và địa danh.
types
Loại:  Array<string>
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 Các loại để biết thêm thông tin.
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 danh. Bạn có thể không điền thông tin này nếu địa điểm tham quan không kết nối với phần mạng lưới đường bộ 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 bộ.

Giao diện Area

google.maps.Areagiao diện

Một địa điểm là một khu vực nhỏ, chẳng hạn như khu dân cư, địa điểm phụ hoặc khu phức hợp lớn có chứa vị trí mục tiêu.
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ơ sở. Có thể dùng để phân giải thêm thông tin về khu vực thông qua Chi tiết về địa điểm hoặc Tra cứu mã địa điểm.

Hằng số chứa

Hằng số google.maps.Containment

Một enum biểu thị 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 Thư viện trong Maps JavaScript API.
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 khu vực, gần với rìa.
WITHIN Vị trí mục tiêu nằm trong khu vực, gần với trung tâm.

Hằng số SpatialRelationship

Hằng số google.maps.SpatialRelationship

Một enum biểu thị mối quan hệ về không gian giữa điểm mốc và mục tiêu.

Truy cập bằng cách gọi const {SpatialRelationship} = await google.maps.importLibrary("geocoding").
Xem Thư viện trong Maps JavaScript API.
ACROSS_THE_ROAD Mục tiêu nằm ngay đối diện với địa danh ở phía bên kia đường.
AROUND_THE_CORNER Không nằm trên cùng tuyến đường với địa danh nhưng chỉ cách một ngã rẽ.
BEHIND Gần cấu trúc của địa danh nhưng ở xa điểm tiếp cận của địa danh.
BESIDE Mục tiêu nằm ngay bên cạnh địa điểm nổi tiếng.
DOWN_THE_ROAD Trên cùng tuyến đường với địa danh 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ệ nào cụ thể hơn bên dưới được áp dụng.
WITHIN Địa điểm có hình học không gian và mục tiêu nằm trong phạm vi của địa điểm đó.