Method: geocode.address.geocodeAddressQuery

Phương thức này thực hiện một mã hoá địa lý địa chỉ, giúp liên kết một địa chỉ với một LatLng. Công cụ 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ố
Tham số 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 trạng thái sau:
addressQuery

string

Địa chỉ không có cấu trúc để mã hoá địa lý.

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 điểm thiên vị, tức là 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 là 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ụ.
Tham số 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 trạng thái sau:
address

object (PostalAddress)

Địa chỉ có cấu trúc để mã hoá địa lý ở định dạng địa chỉ bưu chính.

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