Package google.maps.locationselection.v1beta

Índice

LocationSelectionBeta

O serviço para encontrar lugares próximos e pontos de retirada e entrega associados.

FindNearbyPlaces

rpc FindNearbyPlaces(FindNearbyPlacesRequest) returns (FindNearbyPlacesResponse)

Encontre lugares por perto de um determinado local.

FindPickupPointsForLocation

rpc FindPickupPointsForLocation(FindPickupPointsForLocationRequest) returns (FindPickupPointsForLocationResponse)

Encontre pontos de retirada em um determinado local.

FindPickupPointsForPlace

rpc FindPickupPointsForPlace(FindPickupPointsForPlaceRequest) returns (FindPickupPointsForPlaceResponse)

Encontrar pontos de retirada para um determinado lugar.

Endereço

Endereço de um lugar.

Campos
formatted_address

FormattedAddress

Um endereço completo e legível para humanos.

address_components[]

AddressComponent

Uma lista de componentes de endereço.

AddressComponent

Um componente de endereço que descreve uma parte do endereço.

Campos
component_text

string

O nome desse componente que descreve parte do endereço. Por exemplo, "California" ou "Amphitheatre Parkway".

component_text_short_form

string

A forma abreviada do texto do componente. Por exemplo, "CA" para "Califórnia" e "US" para "Estados Unidos".

types[]

string

Os tipos desse componente que descrevem parte do endereço. Para ver uma lista de tipos compatíveis, consulte https://developers.google.com/places/web-service/supported_types#table2.

Complexo

Composto associado a um lugar.

Campos
type

CompoundType

Tipo de composto.

geometry

Geometry

A geometria associada ao composto.

entrances[]

Entrance

Lista de entradas associadas ao complexo.

CompoundTypeEnums

Os tipos de compostos

CompoundType

Valor do tipo composto.

Enums
COMPOUND_TYPE_UNSPECIFIED Tipo de composto desconhecido.
SECTION Seção composta. https://support.google.com/mapskb/answer/7054299
BUILDING Edifício composto. https://support.google.com/mapskb/answer/7013011
GROUNDS Terrenos de um complexo. https://support.google.com/mapskb/answer/7046859

Entrada

Entrada de um lugar.

Campos
location

LatLng

O local da entrada.

FindNearbyPlacesRequests

Mensagem de solicitação de lugares por perto.

Campos
localization_preferences

LocalizationPreferences

Obrigatório. Preferências usadas para localizar os textos na resposta, por exemplo, nome e endereço.

search_location

LatLng

Obrigatório. Local onde os lugares precisam ser encontrados.

max_results

int32

Obrigatório. Número máximo de resultados a serem retornados. Precisa ser maior que 0.

wifi_access_points[]

WiFiAccessPoint

Pontos de acesso Wi-Fi ao redor do local solicitado. Usado para fornecer resultados de pesquisa de maior qualidade.

FindNearbyPlacesResponse

Encontre lugares por perto para uma determinada mensagem de resposta de local.

Campos
place_results[]

PlaceResult

Lista ordenada dos lugares encontrados. Pode ficar vazio se nenhum lugar for encontrado ao redor do local da solicitação. A ordem é baseada em uma combinação de probabilidade e distância.

FindPickupPointsForLocationRequest

Mensagem de solicitação de FindPickupPointsForLocation.

Campos
localization_preferences

LocalizationPreferences

Obrigatório. Preferências usadas para localizar os textos na resposta, por exemplo, nome e endereço.

search_location

LatLng

Obrigatório. Local a ser usado para pesquisar pontos de retirada e calcular distâncias e ETAs até os pontos de retirada.

order_by

PickupPointOrder

Obrigatório. Ordem a ser usada ao retornar resultados.

destination

LatLng

Local de destino pretendido do cliente. Define quando solicitar pontos de retirada classificados por ETA do destino.

max_results

int32

Obrigatório. Número máximo de resultados a serem retornados. Precisa ser maior que 0.

travel_modes[]

TravelMode

Obrigatório. Somente os pontos de embarque que permitem pelo menos um dos meios de transporte especificados são retornados. Modos de transporte compatíveis: DRIVING e TWO_WHEELER. É necessário especificar pelo menos um modo.

compute_walking_eta

bool

Se verdadeiro, o HEC a pé do local de pesquisa até o ponto de embarque é calculado.

compute_driving_eta

bool

Se for verdadeiro e o destino for especificado, o ETA de carro do ponto de partida até o destino será calculado.

wifi_access_points[]

WiFiAccessPoint

Pontos de acesso Wi-Fi ao redor do local de pesquisa. Usado para fornecer resultados de pesquisa de maior qualidade.

FindPickupPointsForLocationResponse

Encontrar pontos de retirada para a mensagem de resposta de local.

Campos
place_pickup_point_results[]

PlacePickupPointResult

Pontos de retirada próximos com o ID de lugar associado. Os resultados nessa lista são ordenados de acordo com os critérios fornecidos na solicitação. O número de resultados em "place_pickup_point_results" pode exceder o número de resultados em "place_results".

place_results[]

PlaceResult

Detalhes sobre os lugares associados aos pontos de retirada próximos. Os resultados nessa lista não estão ordenados.

FindPickupPointsForPlaceRequest

Mensagem de solicitação de FindPickupPointsForPlace.

Campos
place_id

string

Obrigatório. ID do local para o qual os pontos de retirada estão sendo solicitados.

localization_preferences

LocalizationPreferences

Obrigatório. Preferências usadas para localizar os textos na resposta, por exemplo, nome e endereço.

search_location

LatLng

Local a ser usado para pesquisar pontos de retirada e calcular distâncias e ETAs até os pontos de retirada. Se não for definido, será usado o local associado ao ID de lugar fornecido.

order_by

PickupPointOrder

Obrigatório. Ordem a ser usada ao retornar resultados.

destination

LatLng

Local de destino pretendido do cliente. Define se os pontos de retirada precisam ser ordenados pelo ETA do destino.

max_results

int32

Obrigatório. Número máximo de resultados a serem retornados. Precisa ser maior que 0.

travel_modes[]

TravelMode

Obrigatório. Somente os pontos de embarque que permitem pelo menos um dos meios de transporte especificados são retornados. Modos de transporte compatíveis: DRIVING e TWO_WHEELER. É necessário especificar pelo menos um modo.

compute_walking_eta

bool

Se verdadeiro, o HEC a pé do local de pesquisa até o ponto de embarque é calculado.

compute_driving_eta

bool

Se for verdadeiro e o destino for especificado, o ETA de carro do ponto de partida até o destino será calculado.

FindPickupPointsForPlaceResponse

Encontre pontos de retirada para a mensagem de resposta sobre o lugar.

Campos
pickup_point_results[]

PickupPointResult

Pontos de retirada que correspondem aos critérios da solicitação. Pode ficar vazio se nenhum ponto de retirada atender aos critérios da solicitação.

place_result

PlaceResult

Lugar associado ao ID de lugar fornecido na solicitação.

FormattedAddress

Um endereço completo e legível para a entidade que contém essa mensagem.

Campos
lines[]

string

As linhas de texto que descrevem o endereço. Pelo menos uma linha precisa estar presente.

Geometria

Geometria de um lugar.

Campos
location

LatLng

Ponto central da entidade que contém esta mensagem.

viewport

Viewport

Uma janela de visualização adequada para exibir o lugar em um mapa de tamanho médio.

display_boundary

Struct

Especifica um polígono usando o formato de polígono GeoJSON

LocalizationPreferences

Um endereço completo e legível para a entidade que contém essa mensagem.

Campos
language_code

string

Obrigatório. Tag de idioma BCP-47 usada para localização dos textos. Exemplos de tags de idioma incluem "en-US", "hi-IN", "fr-CA" etc.

region_code

string

Obrigatório. O código de país/região Unicode (CLDR) do local de origem da solicitação, como "US" e "419".

Para mais informações, consulte http://www.unicode.org/reports/tr35/#unicode_region_subtag.

PickupPoint

Detalhes sobre um ponto de retirada ou entrega.

Campos
id

string

Um código exclusivo para o ponto de embarque. Precisa estar presente.

display_name

string

Nome curto e legível do ponto de embarque. Localizado de acordo com a preferência fornecida na solicitação.

address

Address

Endereço do local de retirada.

description

string

Uma descrição mais longa do ponto de retirada, que pode incluir como chegar ao local.

location

LatLng

Local do ponto de embarque, onde um passageiro ou destinatário encontra o motorista. Precisa estar presente.

PickupPointOrderEnums

Conjunto de valores que especificam a ordem de classificação dos pontos de retirada correspondentes.

PickupPointOrder

Valor do pedido do ponto de retirada.

Enums
PICKUP_POINT_ORDER_UNSPECIFIED Ordem do ponto de retirada não especificada. O padrão é DISTANCE_FROM_ORIGIN.
DISTANCE_FROM_SEARCH_LOCATION Ordem crescente da distância em linha reta do local de pesquisa até o ponto de retirada retornado.
WALKING_ETA_FROM_SEARCH_LOCATION Ordem crescente pelo tempo de caminhada do consumidor do local de pesquisa até o ponto de retirada.
DRIVING_ETA_FROM_PICKUP_POINT_TO_DESTINATION Ordem crescente de ETA de carro do ponto de coleta até o destino do consumidor. Esse modo só pode ser usado quando um destino é definido e compute_driving_eta é verdadeiro. Quando vários travel_modes são informados na solicitação, a ordem é baseada no primeiro travel_mode na solicitação.

PickupPointResult

Detalhes sobre um resultado da pesquisa de pontos de retirada.

Campos
pickup_point

PickupPoint

O ponto de embarque real que corresponde à solicitação.

distance_meters

float

A distância em linha reta deste ponto de partida até o search_location especificado na solicitação.

travel_details[]

TravelDetail

Os detalhes associados à viagem de ida e volta ao ponto de embarque para cada meio de transporte solicitado.

Lugar

Detalhes sobre um lugar.

Campos
place_id

string

ID do lugar. Um ID de lugar é um texto que identifica exclusivamente um local. https://developers.google.com/places/web-service/place-id

display_name

string

Nome do lugar localizado. Localizado de acordo com a preferência fornecida na solicitação.

language_code

string

Código do idioma dos campos de texto associados ao lugar. Por exemplo, "nome" e "endereço".

address

Address

Endereço do lugar.

geometry

Geometry

Geometria do lugar.

types[]

string

Um conjunto de tags de tipo para este resultado. Por exemplo, "political" e "locality". https://developers.google.com/places/web-service/supported_types

associated_compounds[]

Compound

Os compostos associados ao lugar.

PlacePickupPointResult

Pontos de retirada com o ID de lugar associado.

Campos
pickup_point_result

PickupPointResult

Detalhes sobre o ponto de retirada. Precisa estar presente.

associated_place_id

string

ID do lugar associado.

PlaceResult

Detalhes sobre um resultado da pesquisa de lugares.

Campos
place

Place

Detalhes sobre um lugar.

distance_meters

float

A distância em linha reta do local de pesquisa até a geometria ou o centro do lugar.

TrafficRestrictionEnums

Tipos de restrição de tráfego para um local.

TrafficRestriction

Valor da restrição de tráfego.

Enums
TRAFFIC_RESTRICTION_UNSPECIFIED A restrição não foi especificada.
NO_RESTRICTION Nenhuma restrição de tráfego é aplicada.
OTHER_RESTRICTION Algumas restrições de trânsito podem ser aplicadas, como a via ser particular ou haver uma taxa para acessar o local associado.

TravelDetail

Os detalhes associados à viagem.

Campos
travel_mode

TravelMode

O modo de transporte em que o HEC é calculado.

estimated_arrival_time

Timestamp

O horário estimado de chegada. O HEC a pé é calculado do local de pesquisa até o local do ponto de embarque quando compute_walking_eta está definido na solicitação. O tempo estimado de chegada é calculado do ponto de coleta até o destino para cada modo de transporte não pedestre solicitado quando compute_driving_eta e destination são definidos na solicitação. O ETA para dirigir é calculado com base no trânsito e NÃO está sujeito a restrições de congestionamento.

traffic_restriction

TrafficRestriction

A restrição que se aplica ao modo de viagem.

TravelModeEnums

A lista de modos de transporte disponíveis para um local.

TravelMode

Valor do meio de transporte.

Enums
TRAVEL_MODE_UNSPECIFIED O modo de viagem não foi especificado.
WALKING Caminhada, usada para pedestres.
DRIVING Para condução, usado em carros de passageiros.
TWO_WHEELER Veículo motorizado de duas rodas (como moto ou ciclomotor).

WiFiAccessPoint

Informações do ponto de acesso Wi-Fi.

Campos
mac_address

int64

O endereço MAC do ponto de acesso.

strength_dbm

sint32

A intensidade do sinal do ponto de acesso, em dBm.