Package google.maps.locationselection.v1beta

Chỉ mục

LocationSelectionBeta

Dịch vụ cung cấp các địa điểm lân cận và các điểm đến lấy hàng và trả hàng được liên kết.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

Tìm các địa điểm lân cận cho một vị trí cụ thể.
FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

Tìm điểm đến lấy hàng cho một vị trí nhất định.
FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

Tìm điểm đến lấy hàng cho một địa điểm nhất định.

Địa chỉ

Địa chỉ của một địa điểm.

Trường
formatted_address

FormattedAddress

Địa chỉ đầy đủ, con người có thể đọc được cho địa điểm này.
address_components[]

AddressComponent

Danh sách các thành phần địa chỉ.

AddressComponent

Một thành phần địa chỉ mô tả một phần của địa chỉ.

Trường
component_text

string

Tên của thành phần này mô tả một phần của địa chỉ. Ví dụ: "California", "Amphitheatre Parkway".
component_text_short_form

string

Dạng ngắn của văn bản thành phần. Ví dụ: "CA" cho "California" và "US" cho "Hoa Kỳ".
types[]

string

Các loại thành phần này mô tả một phần của địa chỉ. Để biết danh sách các loại được hỗ trợ, hãy xem https://developers.google.com/places/web-service/supported_types#table2

Khu vực khép kín

Khu phức hợp liên kết với một địa điểm.

Trường
type

CompoundType

Loại hợp chất.
geometry

Geometry

Hình học liên kết với hợp chất.
entrances[]

Entrance

Danh sách lối vào liên quan đến khu phức hợp.

CompoundTypeEnums

Các loại hợp chất

CompoundType

Giá trị của loại hợp chất.

Enum
COMPOUND_TYPE_UNSPECIFIED Không xác định được Loại hợp chất.
SECTION Mục khu phức hợp. https://support.google.com/mapskb/answer/7054299
BUILDING Toà nhà phức hợp. https://support.google.com/mapskb/answer/7013011
GROUNDS Khu đất phức hợp. https://support.google.com/mapskb/answer/7046859

Lối vào

Lối vào của một địa điểm.

Trường
location

LatLng

Vị trí của lối vào.

FindNearbyPlacesRequest

Tin nhắn yêu cầu tìm địa điểm lân cận.

Trường
localization_preferences

LocalizationPreferences

Bắt buộc. Lựa chọn ưu tiên dùng để bản địa hoá văn bản trong câu trả lời, ví dụ: tên và địa chỉ.
search_location

LatLng

Bắt buộc. Vị trí nơi cần tìm các địa điểm.
max_results

int32

Bắt buộc. Số lượng kết quả tối đa sẽ được trả về. Phải lớn hơn 0.
wifi_access_points[]

WiFiAccessPoint

Điểm truy cập Wi-Fi xung quanh vị trí yêu cầu. Dùng để cung cấp kết quả tìm kiếm chất lượng cao hơn.

FindNearbyPlacesResponse

Tìm các địa điểm lân cận cho một thông báo phản hồi vị trí nhất định.

Trường
place_results[]

PlaceResult

Danh sách địa điểm tìm thấy theo thứ tự. Có thể trống nếu không tìm thấy địa điểm nào xung quanh vị trí yêu cầu. Thứ tự được sắp xếp dựa trên tổ hợp xác suất và khoảng cách.

FindPickupPointsForLocationRequest

Thông báo của yêu cầu FindPickupPointsForLocation.

Trường
localization_preferences

LocalizationPreferences

Bắt buộc. Lựa chọn ưu tiên dùng để bản địa hoá văn bản trong câu trả lời, ví dụ: tên và địa chỉ.
search_location

LatLng

Bắt buộc. Vị trí để dùng để tìm kiếm điểm đón và tính khoảng cách cũng như giờ đến lấy hàng.
order_by

PickupPointOrder

Bắt buộc. Sắp xếp để sử dụng khi trả về kết quả.
destination

LatLng

Vị trí đích đến mà khách hàng dự định. Đặt khi yêu cầu điểm đến lấy hàng được sắp xếp theo thời gian đến dự kiến của điểm đến.
max_results

int32

Bắt buộc. Số kết quả tối đa được trả về. Phải lớn hơn 0.
travel_modes[]

TravelMode

Bắt buộc. Hệ thống chỉ trả về những điểm đón cho phép ít nhất một trong các phương thức di chuyển đã chỉ định. Các chế độ di chuyển được hỗ trợ: DRIVING (Lái xe) và TWO_WHEELER (Xe hai bánh). Bạn phải chỉ định ít nhất một chế độ.
compute_walking_eta

bool

Nếu đúng, thời gian đến dự kiến khi đi bộ từ vị trí tìm kiếm đến điểm đón khách sẽ được tính.
compute_driving_eta

bool

Nếu bạn chỉ định true và chỉ định điểm đến, thì giờ đến dự kiến lái xe từ điểm đón đến điểm đến sẽ được tính.
wifi_access_points[]

WiFiAccessPoint

Điểm truy cập Wi-Fi xung quanh vị trí tìm kiếm. Dùng để cung cấp kết quả tìm kiếm chất lượng cao hơn.

FindPickupPointsForLocationResponse

Tìm điểm đến lấy hàng cho thông báo phản hồi về vị trí.

Trường
place_pickup_point_results[]

PlacePickupPointResult

Điểm đến lấy hàng ở gần có mã địa điểm được liên kết. Các kết quả trong danh sách này được sắp xếp theo tiêu chí được đưa ra trong yêu cầu. Số kết quả trong "place_pickup_point_results" có thể vượt quá số kết quả trong "place_results".
place_results[]

PlaceResult

Thông tin chi tiết về các địa điểm liên kết với các điểm đến lấy hàng lân cận. Các kết quả trong danh sách này không được sắp xếp.

FindPickupPointsForPlaceRequest

Thông báo yêu cầu FindPickupPointsForPlace.

Trường
place_id

string

Bắt buộc. Mã địa điểm của địa điểm mà bạn yêu cầu điểm đến lấy hàng.
localization_preferences

LocalizationPreferences

Bắt buộc. Lựa chọn ưu tiên dùng để bản địa hoá văn bản trong câu trả lời, ví dụ: tên và địa chỉ.
search_location

LatLng

Vị trí để dùng để tìm kiếm điểm đón và tính khoảng cách cũng như giờ đến lấy hàng. Nếu bạn không đặt chính sách này, thì vị trí của địa điểm liên kết với mã địa điểm đã cho sẽ được sử dụng.
order_by

PickupPointOrder

Bắt buộc. Sắp xếp để sử dụng khi trả về kết quả.
destination

LatLng

Vị trí đích đến mà khách hàng dự định. Đặt xem có yêu cầu sắp xếp các điểm đến theo thời gian đến dự kiến (ETA) của điểm đến hay không.
max_results

int32

Bắt buộc. Số lượng kết quả tối đa sẽ được trả về. Phải lớn hơn 0.
travel_modes[]

TravelMode

Bắt buộc. Hệ thống chỉ trả về những điểm đón cho phép ít nhất một trong các phương thức di chuyển đã chỉ định. Các chế độ di chuyển được hỗ trợ: DRIVING (Lái xe) và TWO_WHEELER (Xe hai bánh). Bạn phải chỉ định ít nhất một chế độ.
compute_walking_eta

bool

Nếu đúng, thời gian đến dự kiến khi đi bộ từ vị trí tìm kiếm đến điểm đón khách sẽ được tính.
compute_driving_eta

bool

Nếu là true và đích đến được chỉ định, thì thời gian dự kiến đến bằng ô tô từ điểm đón đến đích đến sẽ được tính toán.

FindPickupPointsForPlaceResponse

Tìm điểm đến lấy hàng cho tin nhắn phản hồi về địa điểm.

Trường
pickup_point_results[]

PickupPointResult

Điểm đến lấy hàng phù hợp với tiêu chí yêu cầu. Có thể để trống nếu không có điểm đến lấy hàng nào khớp với tiêu chí yêu cầu.
place_result

PlaceResult

Địa điểm liên kết với mã địa điểm nhất định trong yêu cầu.

FormattedAddress

Địa chỉ đầy đủ mà con người có thể đọc được của pháp nhân chứa thư này.

Trường
lines[]

string

Các dòng văn bản mô tả địa chỉ. Bạn phải có ít nhất một dòng.

Hình học

Hình học của một địa điểm.

Trường
location

LatLng

Điểm trung tâm của thực thể chứa thông báo này.
viewport

Viewport

Khung nhìn phù hợp để hiển thị địa điểm trên bản đồ có kích thước trung bình.
display_boundary

Struct

Chỉ định một đa giác bằng cách sử dụng định dạng Đa giác GeoJSON

LocalizationPreferences

Địa chỉ đầy đủ mà con người có thể đọc được của pháp nhân chứa thư này.

Trường
language_code

string

Bắt buộc. Thẻ ngôn ngữ BCP-47 dùng để bản địa hoá văn bản. Ví dụ về thẻ ngôn ngữ bao gồm "en-US", "hi-IN", "fr-CA", v.v.
region_code

string

Bắt buộc. Mã quốc gia/khu vực Unicode (CLDR) của vị trí phát sinh yêu cầu, chẳng hạn như "US" và "419".

Để biết thêm thông tin, hãy xem http://www.unicode.org/reports/tr35/#unicode_region_subtag.

Điểm lấy hàng

Thông tin chi tiết về điểm đến hoặc điểm trả hàng.

Trường
id

string

Mã nhận dạng duy nhất của điểm đến lấy hàng. Phải có.
display_name

string

Tên ngắn, dễ đọc của điểm đến lấy hàng. Đã bản địa hoá theo lựa chọn ưu tiên được cung cấp trong yêu cầu.
address

Address

Địa chỉ của điểm đón.
description

string

Nội dung mô tả dài hơn về điểm đón, có thể bao gồm cả cách đến vị trí đó.
location

LatLng

Vị trí của điểm đón; nơi người đi xe hoặc người nhận gặp tài xế. Phải có.

PickupPointOrderEnums

Tập hợp các giá trị chỉ định thứ tự sắp xếp của các điểm đến lấy hàng trùng khớp.

PickupPointOrder

Giá trị của đơn đặt hàng tại điểm đến lấy hàng.

Enum
PICKUP_POINT_ORDER_UNSPECIFIED Chưa xác định thứ tự của điểm đến lấy hàng. Giá trị mặc định là DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION Thứ tự tăng dần theo khoảng cách theo đường thẳng từ vị trí tìm kiếm đến điểm đến lấy hàng được trả về.
WALKING_ETA_FROM_SEARCH_LOCATION Sắp xếp theo thứ tự tăng dần theo thời gian đi bộ của người tiêu dùng từ vị trí tìm kiếm đến điểm đến lấy hàng.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION Đơn đặt hàng tăng dần bằng cách lái xe từ điểm đến lấy hàng đến điểm đến của người tiêu dùng. Bạn chỉ có thể sử dụng chế độ này khi đã đặt điểm đến và compute_driving_eta là true. Khi có nhiều travel_modes được cung cấp trong yêu cầu, thứ tự sẽ dựa trên travel_mode đầu tiên trong yêu cầu.

PickupPointResult

Thông tin chi tiết về một kết quả tìm kiếm điểm đến lấy hàng.

Trường
pickup_point

PickupPoint

Điểm đến lấy hàng thực tế khớp với yêu cầu.
distance_meters

float

Khoảng cách theo đường thẳng từ điểm đón này đến search_location được chỉ định trong yêu cầu.
travel_details[]

TravelDetail

Thông tin chi tiết liên quan đến việc đi đến và đi từ điểm đón này đối với mỗi phương tiện đi lại mà bạn yêu cầu.

Địa điểm

Thông tin chi tiết về một địa điểm.

Trường
place_id

string

Mã địa điểm của địa điểm. Mã địa điểm là văn bản giúp xác định riêng một địa điểm. https://developers.google.com/places/web-service/place-id
display_name

string

Tên của địa điểm đã được bản địa hoá. Được bản địa hoá theo lựa chọn ưu tiên được cung cấp trong yêu cầu.
language_code

string

Mã ngôn ngữ của các trường văn bản liên kết với địa điểm. Ví dụ: "tên" và "địa chỉ".
address

Address

Địa chỉ của địa điểm.
geometry

Geometry

Hình học của địa điểm.
types[]

string

Một tập hợp thẻ loại cho kết quả này. Ví dụ: "chính trị" và "khu vực địa lý". https://developers.google.com/places/web-service/supported_types
associated_compounds[]

Compound

Các hợp chất liên kết với địa điểm.

PlacePickupPointResult

Điểm đến lấy hàng có mã địa điểm được liên kết.

Trường
pickup_point_result

PickupPointResult

Thông tin chi tiết về điểm đến lấy hàng. Phải có.
associated_place_id

string

Mã địa điểm của địa điểm được liên kết.

PlaceResult

Thông tin chi tiết về một kết quả tìm kiếm địa điểm.

Trường
place

Place

Thông tin chi tiết về một địa điểm.
distance_meters

float

Khoảng cách theo đường thẳng từ vị trí tìm kiếm đến hình học hoặc tâm của địa điểm.

TrafficRestrictionEnums

Các loại hạn chế về giao thông cho một vị trí.

TrafficRestriction

Giá trị của quy định hạn chế lưu lượng truy cập.

Enum
TRAFFIC_RESTRICTION_UNSPECIFIED Quy định hạn chế không phải là chưa xác định.
NO_RESTRICTION Không có quy định hạn chế nào về lưu lượng truy cập.
OTHER_RESTRICTION Một số quy định hạn chế về giao thông có thể được áp dụng, chẳng hạn như đường là đường tư nhân hoặc có tính phí để truy cập vào vị trí được liên kết.

TravelDetail

Thông tin chi tiết liên quan đến chuyến đi.

Trường
travel_mode

TravelMode

Phương thức di chuyển mà theo đó ETA được tính toán.
estimated_arrival_time

Timestamp

Thời gian đến dự kiến. Thời gian ước tính để đi bộ được tính từ vị trí tìm kiếm đến vị trí điểm đến lấy hàng khi bạn đặt compute_walking_eta trong yêu cầu. Thời gian dự kiến đến bằng ô tô được tính từ vị trí điểm đón đến đích cho mỗi phương thức di chuyển không phải đi bộ được yêu cầu khi bạn đặt compute_driving_eta và đích đến trong yêu cầu. Thời gian ước tính để lái xe được tính theo lưu lượng truy cập và KHÔNG chịu các hạn chế về tình trạng tắc nghẽn.
traffic_restriction

TrafficRestriction

Quy định hạn chế áp dụng cho phương thức đi lại.

TravelModeEnums

Danh sách các phương tiện di chuyển có thể dùng để di chuyển đến một địa điểm.

TravelMode

Giá trị của phương tiện đi lại.

Enum
TRAVEL_MODE_UNSPECIFIED Chưa chỉ định phương tiện đi lại.
WALKING Đi bộ, dùng cho người đi bộ.
DRIVING Lái xe, dùng cho ô tô chở khách.
TWO_WHEELER Xe hai bánh chạy bằng động cơ (chẳng hạn như xe mô tô hoặc xe gắn máy).

WiFiAccessPoint

Thông tin về điểm truy cập Wi-Fi.

Trường
mac_address

int64

Địa chỉ MAC của điểm truy cập.
strength_dbm

sint32

Cường độ tín hiệu của điểm truy cập, tính bằng dBm.