Package google.maps.geocode.v4beta

Chỉ mục

• GeocodeService (giao diện)
• GeocodeAddressRequest (thông báo)
• GeocodeAddressRequest.LocationBias (thông báo)
• GeocodeAddressResponse (thông báo)
• GeocodeLocationRequest (thông báo)
• GeocodeLocationResponse (thông báo)
• GeocodePlaceRequest (thông báo)
• GeocodeResult (thông báo)
• GeocodeResult.AddressComponent (thông báo)
• GeocodeResult.Granularity (enum)
• PlusCode (thông báo)

GeocodeService

Dịch vụ để thực hiện việc mã hoá địa lý.

GeocodeAddress

rpc GeocodeAddress(GeocodeAddressRequest) returns (GeocodeAddressResponse) Phương thức này thực hiện mã địa lý địa chỉ, liên kết một địa chỉ với LatLng. Mã này cũng cung cấp thông tin có cấu trúc về địa chỉ. Phạm vi uỷ quyền Yêu cầu một trong các phạm vi OAuth sau: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.address

GeocodeLocation

rpc GeocodeLocation(GeocodeLocationRequest) returns (GeocodeLocationResponse) Phương thức này thực hiện mã địa lý vị trí, liên kết LatLng với một địa chỉ. Mã này cũng cung cấp thông tin có cấu trúc về địa chỉ. Phạm vi uỷ quyền Yêu cầu một trong các phạm vi OAuth sau: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.location

GeocodePlace
rpc GeocodePlace(GeocodePlaceRequest) returns (GeocodeResult) Phương thức này thực hiện tra cứu mã địa lý bằng mã địa điểm. Phạm vi uỷ quyền Yêu cầu một trong các phạm vi OAuth sau: https://www.googleapis.com/auth/cloud-platform https://www.googleapis.com/auth/maps-platform.geocode https://www.googleapis.com/auth/maps-platform.geocode.place

GeocodeAddressRequest

Thông báo yêu cầu cho GeocodeService.GeocodeAddress.

Trường
location_bias	LocationBias Không bắt buộc. Khu vực cần tìm kiếm. Vị trí này đóng vai trò là độ lệch, tức là kết quả xung quanh vị trí đã cho có thể được trả về.
language_code	string Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code	string Không bắt buộc. Mã vùng. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành. Tham số này cũng sẽ ảnh hưởng, nhưng không hoàn toàn hạn chế kết quả của dịch vụ.
Trường hợp hợp nhất address_input. Địa chỉ cần mã hoá địa lý. address_input chỉ có thể là một trong những loại sau:
address_query	string Địa chỉ không có cấu trúc để mã hoá địa lý.
address	PostalAddress Địa chỉ có cấu trúc để mã hoá địa lý ở định dạng địa chỉ bưu chính.

LocationBias

Khu vực cần tìm kiếm. Vị trí này đóng vai trò là độ lệch, tức là kết quả xung quanh vị trí đã cho có thể được trả về.

Trường
Trường hợp hợp nhất type. Các loại thiên vị vị trí. type chỉ có thể là một trong những loại sau:
rectangle	Viewport Hộp hình chữ nhật được xác định bởi góc đông bắc và tây nam. rectangle.high() phải là điểm đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm tây nam của khung nhìn hình chữ nhật. rectangle.low().latitude() không được lớn hơn rectangle.high().latitude(). Điều này sẽ dẫn đến một dải vĩ độ trống. Khung nhìn hình chữ nhật không được rộng hơn 180 độ.

GeocodeAddressResponse

Thông báo phản hồi cho GeocodeService.GeocodeAddress.

Trường
results[]	GeocodeResult Kết quả mã hoá địa lý.

GeocodeLocationRequest

Thông báo yêu cầu cho GeocodeService.GeocodeLocation.

Trường
language_code	string Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code	string Không bắt buộc. Mã vùng. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành.
types[]	string Không bắt buộc. Một tập hợp các thẻ loại để hạn chế kết quả. Những kết quả không có bất kỳ loại nào được chỉ định sẽ bị xoá. Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types.
granularity[]	Granularity Không bắt buộc. Bộ lọc của một hoặc nhiều enum độ chi tiết về vị trí.
Trường hợp hợp nhất location_input. Vị trí cần mã hoá địa lý. location_input chỉ có thể là một trong những loại sau:
location_query	string Vị trí ở định dạng chuỗi "lat,lng". Ví dụ: "64.7611872,-18.4705364".
location	LatLng Vị trí ở định dạng có cấu trúc.

GeocodeLocationResponse

Thông báo phản hồi cho GeocodeService.GeocodeLocation.

Trường
results[]	GeocodeResult Kết quả mã hoá địa lý.
plus_code	PlusCode Plus code của vị trí trong yêu cầu.

GeocodePlaceRequest

Thông báo yêu cầu cho GeocodeService.GeocodePlace.

Trường
place	string Bắt buộc. Giá trị nhận dạng địa điểm để mã hoá địa lý theo định dạng places/{place}.
language_code	string Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
region_code	string Không bắt buộc. Mã vùng. Mã vùng, được chỉ định dưới dạng giá trị gồm hai ký tự ccTLD ("miền cấp cao nhất"). Tham số này ảnh hưởng đến kết quả dựa trên luật hiện hành.

GeocodeResult

Kết quả mã địa lý chứa thông tin địa lý về một địa điểm.

Trường
place	string Giá trị nhận dạng địa điểm đủ điều kiện cho kết quả này. Theo định dạng "//places.googleapis.com/places/{placeID}". Hãy xem https://developers.google.com/maps/documentation/places/web-service/place-id để biết thêm thông tin chi tiết.
place_id	string Mã địa điểm của kết quả này.
location	LatLng Toạ độ latlng của địa chỉ này.
granularity	Granularity Độ chi tiết của vị trí.
viewport	Viewport Khung nhìn phù hợp để hiển thị kết quả mã địa lý.
bounds	Viewport Hộp giới hạn cho địa chỉ.
formatted_address	string Địa chỉ được định dạng một dòng.
postal_address	PostalAddress Địa chỉ ở định dạng địa chỉ bưu chính.
address_components[]	AddressComponent Các thành phần lặp lại cho từng cấp độ địa phương.
postal_code_localities[]	LocalizedText Danh sách đầy đủ các địa phương có trong mã bưu chính. Trường này chỉ được điền khi kết quả thuộc loại "postal_code".
types[]	string Một tập hợp thẻ loại cho kết quả này. Ví dụ: "political" và "administrative_area". Để biết danh sách đầy đủ các giá trị có thể có, hãy xem Bảng A và Bảng B tại https://developers.google.com/maps/documentation/places/web-service/place-types.
plus_code	PlusCode Plus code của vị trí trong mã địa lý này.

AddressComponent

Các thành phần có cấu trúc tạo thành địa chỉ được định dạng, nếu có thông tin này.

Trường
long_text	string Nội dung mô tả đầy đủ hoặc tên của thành phần địa chỉ. Ví dụ: thành phần địa chỉ cho quốc gia Úc có thể có tên dài là "Úc".
short_text	string Tên văn bản viết tắt cho thành phần địa chỉ, nếu có. Ví dụ: thành phần địa chỉ cho quốc gia Úc có thể có tên ngắn là "AU".
types[]	string Một mảng cho biết(các) loại thành phần địa chỉ. Hãy xem https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types để biết thêm chi tiết.
language_code	string Ngôn ngữ dùng để định dạng thành phần này, theo ký hiệu CLDR.

Độ chi tiết

Độ chi tiết của vị trí.

Enum
GRANULARITY_UNSPECIFIED	Không được dùng.
ROOFTOP	Vị trí không nội suy của một thửa đất thực tế tương ứng với địa chỉ được so khớp.
RANGE_INTERPOLATED	Nội suy từ một dải số nhà. Ví dụ: nếu chúng ta biết rằng một đoạn của Amphitheatre Pkwy chứa các số từ 1600 đến 1699, thì 1650 có thể được đặt ở giữa các điểm cuối của đoạn đường đó.
GEOMETRIC_CENTER	Tâm hình học của một đối tượng mà chúng ta có dữ liệu đa giác.
APPROXIMATE	Mọi thứ khác.

PlusCode

Plus code (http://plus.codes) là một tệp tham chiếu vị trí có hai định dạng: mã toàn cầu xác định hình chữ nhật 14mx14m (1/8000 độ) hoặc nhỏ hơn và mã phức hợp, thay thế tiền tố bằng một vị trí tham chiếu.

Trường
global_code	string Mã toàn cầu (đầy đủ) của địa điểm, chẳng hạn như "9FWM33GV+HQ", đại diện cho khu vực có kích thước 1/8000 độ x 1/8000 độ (~14 x 14 mét).
compound_code	string Mã hợp chất của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", chứa hậu tố của mã chung và thay thế tiền tố bằng tên được định dạng của một thực thể tham chiếu.