Method: geocode.address.geocodeAddressQuery

Phương thức này thực hiện mã hoá địa lý địa chỉ, tức là liên kết một địa chỉ với một LatLng. Trường này cũng cung cấp thông tin có cấu trúc về địa chỉ.

Yêu cầu HTTP

GET https://geocode.googleapis.com/v4alpha/geocode/address/{addressQuery}

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
Địa chỉ cần mã hoá địa lý. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
addressQuery

string

Địa chỉ không có cấu trúc để mã hoá địa lý.
Kết thúc các trường loại trừ lẫn nhau.

Tham số truy vấn

Thông số
locationBias

object (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à các kết quả xung quanh vị trí đã cho sẽ được ưu tiên.
languageCode

string

Không bắt buộc. Ngôn ngữ mà kết quả sẽ được trả về.
regionCode

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 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 đến kết quả của dịch vụ, nhưng không hạn chế hoàn toàn.
effort

enum (GeocodeAddressRequest.Effort)

Không bắt buộc. Mức độ nỗ lực mà ứng dụng yêu cầu.
Địa chỉ cần mã hoá địa lý. Sau đây là danh sách các trường loại trừ lẫn nhau. Tối đa một trong các trường sẽ được đặt trong phản hồi:
address

object (PostalAddress)

Địa chỉ có cấu trúc để mã hoá địa lý theo định dạng địa chỉ bưu chính.
Kết thúc các trường loại trừ lẫn nhau.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể của GeocodeAddressResponse.

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