Method: geocode.location.geocodeLocation

Phương thức này thực hiện mã hoá địa lý vị trí, tức là liên kết một LatLng với một địa chỉ. 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/location

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

Tham số truy vấn

Thông số
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.

types[]

string

Không bắt buộc. Một tập hợp các thẻ loại để giới hạn kết quả. Những kết quả không có bất kỳ 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[]

enum (GeocodeResult.Granularity)

Không bắt buộc. Bộ lọc gồm một hoặc nhiều enum về mức độ chi tiết của vị trí.

Vị trí 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:
locationQuery

string

Vị trí ở định dạng chuỗi "lat,lng". Ví dụ: "64.7611872,-18.4705364".

location

object (LatLng)

Vị trí ở định dạng có cấu trúc.

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 GeocodeLocationResponse.

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