Method: geocode.location.geocodeLocationQuery

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

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

Tham số đường dẫn

Thông số
Tham số nhóm location_input. Vị trí cần mã hoá địa lý. location_input chỉ có thể là một trong những tham số sau:
locationQuery

string

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

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ã khu vực. 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 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á.

Để 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 của một hoặc nhiều enum mức độ chi tiết vị trí.

Tham số nhóm location_input. Vị trí cần mã hoá địa lý. location_input chỉ có thể là một trong những tham số sau:
location

object (LatLng)

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

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