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

Một 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ột mã địa lý địa chỉ, ánh xạ một địa chỉ đến một LatLng. Ngoài ra, thông tin này còn 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ột mã hoá địa lý vị trí, giúp liên kết một LatLng với một địa chỉ. Ngoài ra, thông tin này còn 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 một thao tác 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	GeocodeAddressRequest.LocationBias Không bắt buộc. Khu vực cần tìm kiếm. Vị trí này đóng vai trò là một thiên kiến, 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ã khu vực, được chỉ định dưới dạng giá trị gồm 2 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 hạn chế hoàn toàn) đến kết quả của dịch vụ.
Trường nhóm address_input. Địa chỉ cần mã hoá địa lý. address_input chỉ có thể là một trong những trạng thá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à một thiên kiến, tức là kết quả xung quanh vị trí đã cho có thể được trả về.

Trường
Trường nhóm type. Các loại thiên kiến về vị trí. type chỉ có thể là một trong những trạng thái sau:
rectangle	Viewport Một hộp hình chữ nhật được xác định bằng góc đông bắc và tây nam. rectangle.high() phải là điểm ở phía đông bắc của khung nhìn hình chữ nhật. rectangle.low() phải là điểm ở phía 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(). Việc 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ã khu vực, được chỉ định dưới dạng giá trị gồm 2 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 nhóm thẻ loại để hạn chế kết quả. Những kết quả không có loại nào được chỉ định sẽ bị xoá. Để xem 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[]	GeocodeResult.Granularity Không bắt buộc. Bộ lọc gồm một hoặc nhiều enum độ chi tiết của vị trí.
Trường nhóm location_input. Vị trí cần mã hoá địa lý. location_input chỉ có thể là một trong những trạng thá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 địa điểm/{địa điểm}.
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ã khu vực, được chỉ định dưới dạng giá trị gồm 2 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ã hoá đị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 cho kết quả này.
location	LatLng LatLng của địa chỉ này.
granularity	GeocodeResult.Granularity Độ chi tiết của vị trí.
viewport	Viewport Một khung hiển thị phù hợp để hiển thị kết quả mã hoá địa lý.
bounds	Viewport Một hộp bao quanh cho địa chỉ.
formatted_address	string Địa chỉ được định dạng trên một dòng.
postal_address	PostalAddress Địa chỉ ở định dạng địa chỉ bưu chính.
address_components[]	GeocodeResult.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. Tham số này chỉ được điền sẵn khi kết quả thuộc loại "postal_code".
types[]	string Một nhóm thẻ loại cho kết quả này. Ví dụ: "political" và "administrative_area". Để xem 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 nên địa chỉ được định dạng, nếu có thông tin này.

Trường
long_text	string Nội dung mô tả hoặc tên đầy đủ của thành phần địa chỉ. Ví dụ: một 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 của 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 viết tắt 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 thông tin chi tiết.
language_code	string Ngôn ngữ dùng để định dạng các 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 được nội suy của một thửa đất thực tế tương ứng với địa chỉ trùng 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 đường Amphitheatre Pkwy có số nhà từ 1600 đến 1699, thì số nhà 1650 có thể được đặt ở giữa hai điểm cuối.
GEOMETRIC_CENTER	Tâm hình học của một đối tượng mà chúng tôi có dữ liệu đa giác.
APPROXIMATE	Mọi thứ khác.

PlusCode

Plus code (http://plus.codes) là thông tin tham chiếu về vị trí có 2 định dạng: mã toàn cầu xác định một hình chữ nhật có kích thước 14 m x 14 m (1/8000 độ) hoặc nhỏ hơn và mã kết 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", biểu thị một khu vực có kích thước 1/8000 x 1/8000 độ (~14 x 14 mét).
compound_code	string Mã kết hợp của địa điểm, chẳng hạn như "33GV+HQ, Ramberg, Na Uy", có chứa hậu tố của mã toàn cầu và thay thế tiền tố bằng tên được định dạng của một thực thể tham chiếu.