Package google.maps.geocode.v4alpha

Índice

DestinationService

Um serviço para recuperar destinos.

Um destino fornece contexto hierárquico sobre um lugar, o que permite, por exemplo, encontrar edifícios de apartamentos dentro de um complexo maior e vice-versa. Ele também fornece pontos de navegação adequados para casos de uso como carona compartilhada ou entrega.

SearchDestinations

rpc SearchDestinations(SearchDestinationsRequest) returns (SearchDestinationsResponse)

Esse método realiza uma pesquisa de destino e retorna uma lista de destinos.

Escopos de autorização

Requer um dos seguintes escopos do OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/maps-platform.geocode

Destino

Um destino. Isso inclui o lugar principal, lugares relacionados, entradas e pontos de navegação.

Campos
primary

PlaceView

O lugar principal identificado pelo primary_query na solicitação.
containing_places[]

PlaceView

Os lugares menos precisos que contêm o lugar principal. Por exemplo, o complexo de apartamentos que contém esse prédio.
sub_destinations[]

PlaceView

Subdestinos mais precisos do lugar principal. Por exemplo, unidades contidas em um prédio.

Observação: em comparação com o SubDestination retornado pela API Places, essa lista de subdestinos é mais completa, e cada subdestino contém mais informações.
landmarks[]

Landmark

Pontos de referência que podem ser usados para comunicar onde fica o destino ou ajudar na chegada.
entrances[]

Entrance

Entradas para esse destino.
navigation_points[]

NavigationPoint

Pontos de navegação para este destino.

Entrada

Uma entrada é um único par de coordenadas de latitude/longitude que define a localização de um ponto de entrada e saída de um lugar.

Campos
location

LatLng

O local da entrada.
tags[]

Entrance.Tag

Uma lista de tags que descrevem a entrada.
place

string

A estrutura em que essa entrada está localizada fisicamente, no formato places/{place_id}.

Tag

Características que descrevem uma entrada.

Enums
TAG_UNSPECIFIED Não utilizado.
PREFERRED

A entrada provavelmente dá acesso físico ao local principal no destino retornado. Um lugar pode ter várias entradas preferenciais. Se uma entrada não tiver essa tag, significa que ela está fisicamente no mesmo edifício que o lugar principal, mas não necessariamente dá acesso a ele.

Por exemplo, se o lugar principal for um restaurante em um centro comercial, as entradas "PREFERRED" serão as que provavelmente levam ao restaurante, enquanto as outras entradas retornadas serão outras entradas do edifício, como as de outros restaurantes no centro comercial.

Se o lugar principal for um prédio, as entradas PREFERRED serão as que levam à parte "principal" do prédio. Por exemplo, em um shopping center, as entradas PREFERRED são as que permitem o acesso à área principal do saguão. No entanto, se uma entrada só permitir o acesso a uma loja na lateral do prédio, ela não será uma entrada PREFERRED.

Observação: uma entrada PREFERRED pode não dar acesso ao local principal, e uma entrada não PREFERRED pode dar acesso ao local principal.

Ponto de referência

Os pontos de referência são usados para comunicar onde fica o destino ou ajudar a chegar até ele.

Campos
tags[]

Landmark.Tag

Tags que descrevem como o ponto de referência pode ser usado no contexto do destino.
Campo de união landmark. O ponto de referência. landmark pode ser apenas de um dos tipos a seguir:
place

PlaceView

O lugar que representa esse ponto de referência.

Tag

A lista de todas as tags possíveis que descrevem como um ponto de referência pode ser usado no contexto de um destino.

Se um endereço tiver as tags ADDRESS e ARRIVAL, isso significa que o ponto de referência é proeminente localmente e está perto do destino.

Enums
TAG_UNSPECIFIED Não utilizado.
ADDRESS Um lugar de destaque local que pode ser usado para identificar a localização geral do destino. Normalmente, a poucos metros do destino. Eles são semelhantes aos pontos de referência retornados pelo recurso de descritores de endereço da API Geocoding: https://developers.google.com/maps/documentation/geocoding/address-descriptors/requests-address-descriptors.
ARRIVAL Um lugar que pode ser usado para ajudar a chegar ao destino. Útil para navegação quando você está perto do destino. Por exemplo, pode ser um lugar que fica do outro lado da rua do destino. Um ponto de referência com essa tag geralmente está mais perto do destino do que os pontos com a tag ADDRESS.

Um ponto de navegação é um local ao lado de uma via onde a navegação pode terminar.

Campos
display_name

LocalizedText

O nome de exibição deste ponto de navegação. Por exemplo, "5th Ave" ou "Portão B".
location

LatLng

Um ponto ao lado do trecho da via onde a navegação deve terminar. O ponto é intencionalmente ligeiramente deslocado da linha central da via para marcar claramente o lado da via em que o lugar está localizado.
travel_modes[]

NavigationPoint.TravelMode

Modos de viagem adequados para este ponto de navegação.
usages[]

NavigationPoint.Usage

Usos compatíveis com este ponto de navegação.

TravelMode

Modos de viagem adequados para este ponto de navegação.

Enums
TRAVEL_MODE_UNSPECIFIED Não utilizado.
DRIVE Adequado para dirigir.
WALK Adequado para caminhadas.

Uso

Usos compatíveis com este ponto de navegação.

Enums
USAGE_UNSPECIFIED Não utilizado.
UNKNOWN Tipo de uso desconhecido. A maioria dos pontos de navegação será UNKNOWN, o que não significa necessariamente que o uso deles seja restrito de alguma forma. Essa navegação ainda pode ser adequada para retirada e/ou entrega.
DROPOFF Adequado para desembarcar um passageiro. Por exemplo, um local de desembarque de carona compartilhada.
PICKUP Adequado para pegar um passageiro. Por exemplo, um local de embarque e desembarque de passageiros de aplicativos de transporte.

PlaceView

Representa uma visualização de um Lugar na API Places. Ele também fornece informações adicionais específicas para destinos, como o tipo de estrutura e o polígono de exibição.

Em alguns casos, um PlaceView com o mesmo ID de lugar pode ser diferente do que é retornado pela API Places para os campos types e display_name.

Campos
place

string

O nome do recurso deste lugar, no formato places/{placeId}.
display_name

LocalizedText

Descrição legível do lugar. Por exemplo, "Portão B", "McDonalds"
primary_type

string

O tipo de lugar principal deste lugar. Consulte https://developers.google.com/maps/documentation/places/web-service/place-types para ver a lista de valores possíveis.

Observação: esse campo nem sempre é preenchido. Esteja preparado para usar o campo types nessas situações.
types[]

string

Todos os tipos de lugar associados a este lugar. Consulte https://developers.google.com/maps/documentation/places/web-service/place-types para ver a lista de valores possíveis.
formatted_address

string

Endereço de uma linha.
postal_address

PostalAddress

Endereço estruturado.
structure_type

PlaceView.StructureType

O tipo de estrutura correspondente a este lugar.
location

LatLng

O local deste lugar. Para lugares com polígonos de exibição, isso pode representar um bom local para colocar um marcador no mapa.
display_polygon

Struct

O contorno do polígono do lugar no formato GeoJSON, usando o formato RFC 7946: https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.

Observação: o formato RFC 7946 é compatível com MultiPolygons. Portanto, um objeto display_polygon pode representar vários polígonos.

StructureType

O tipo de estrutura que este lugar representa.

Enums
STRUCTURE_TYPE_UNSPECIFIED Não utilizado.
POINT Um local de ponto.
SECTION Uma subseção de um edifício.
BUILDING Um edifício.
GROUNDS Uma área grande que normalmente contém vários edifícios, como um campus universitário, um complexo de apartamentos ou um shopping center.

SearchDestinationsRequest

Mensagem de solicitação para DestinationService.SearchDestinations.

Campos
travel_modes[]

NavigationPoint.TravelMode

Opcional. Os meios de transporte para filtrar os pontos de navegação. Isso influencia o campo navigation_points retornado na resposta. Se estiver vazio, os pontos de navegação de todos os meios de transporte poderão ser retornados.
language_code

string

Opcional. Idioma em que os resultados precisam ser retornados.
region_code

string

Opcional. É o código da região. O código da região, especificado como um valor ccTLD ("domínio de nível superior") de dois caracteres. O parâmetro afeta os resultados com base na legislação aplicável. Esse parâmetro também influencia, mas não restringe totalmente, os resultados do serviço.

Campo de união primary_query. Consulte o destino principal. Pode ser um lugar, um endereço totalmente especificado ou um local LatLng. Alguns lugares e endereços com poucas informações não podem ser transformados em um destino.

Os destinos são criados com base na consulta principal especificada.

Observação: somente lugares e endereços que podem ter um destino de navegação são aceitos. Por exemplo, um lugar que representa uma casa ou um complexo de apartamentos pode ser usado como a consulta principal, mas lugares que representam uma localidade ou uma área administrativa não podem ser usados como a consulta principal. primary_query pode ser apenas de um dos tipos a seguir:
place

string

O nome do recurso de um lugar, no formato places/{place_id}.
address_query

SearchDestinationsRequest.AddressQuery

Um endereço.
location_query

SearchDestinationsRequest.LocationQuery

Um local exato.

AddressQuery

O endereço que você quer pesquisar. Especifique endereços de acordo com o formato usado pelo serviço postal do país em questão.

Campos
Campo de união kind. A consulta de endereço. kind pode ser apenas de um dos tipos a seguir:
address

PostalAddress

Um endereço no formato de endereço postal.
address_query

string

Um endereço formatado como uma única linha.

LocationQuery

Uma consulta de local para identificar um destino principal próximo.

Observação: se a consulta de local estiver em um prédio com subunidades, é possível que o lugar principal retornado seja uma subunidade. Nesses casos, o campo "containing_places" vai incluir o edifício.

Campos
Campo de união kind. A consulta de local. kind pode ser apenas de um dos tipos a seguir:
location

LatLng

Um local LatLng exato.

SearchDestinationsResponse

Mensagem de resposta para DestinationService.SearchDestinations.

Campos
destinations[]

Destination

Uma lista de destinos.

O serviço retorna um resultado se um destino principal puder ser identificado de forma inequívoca na consulta principal. Caso contrário, o serviço poderá retornar vários resultados para desambiguação ou nenhum resultado.