Method: places.get

Confira os detalhes de um local com base no nome do recurso, que é uma string no formato places/{placeId}.

Solicitação HTTP

GET https://places.googleapis.com/v1/{name=places/*}

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
name

string

Obrigatório. O nome do recurso de um lugar, no formato places/{placeId}.

Parâmetros de consulta

Parâmetros
languageCode

string

Opcional. Os detalhes do lugar serão exibidos com o idioma preferido, se disponível.

Lista atual de idiomas compatíveis: https://developers.google.com/maps/faq#languagesupport.
regionCode

string

Opcional. O código de país/região Unicode (CLDR) do local de origem da solicitação. Esse parâmetro é usado para exibir os detalhes do lugar, como o nome específico da região, se disponíveis. O parâmetro pode afetar os resultados com base na legislação aplicável. Para mais informações, consulte https://www.unicode.org/cldr/charts/latest/supplemental/territory_language_information.html.

No momento, não é possível usar códigos de região com três dígitos.
sessionToken

string

Opcional. Uma string que identifica uma sessão de preenchimento automático para fins de faturamento. Precisa ser uma string base64 segura para URL e nome de arquivo com no máximo 36 caracteres ASCII. Caso contrário, um erro INVALID_ARGUMENT será retornado.

A sessão começa quando o usuário começa a digitar uma consulta e termina quando seleciona um local e faz uma chamada para Place Details ou Address Validation. Cada sessão pode ter várias consultas, seguidas por uma solicitação do Place Details ou Address Validation. As credenciais usadas para cada solicitação em uma sessão precisam pertencer ao mesmo projeto do Console do Google Cloud. Após a conclusão de uma sessão, o token deixa de ser válido; seu aplicativo deve gerar um novo token para cada sessão. Se o parâmetro sessionToken for omitido ou você reutilizar um token, a sessão vai ser cobrada como se nenhum token de sessão tivesse sido fornecido (cada solicitação é faturada separadamente).

Recomendamos as seguintes diretrizes:

  • Usar tokens de sessão para todas as chamadas do Place Autocomplete.
  • Gerar um novo token para cada sessão. É recomendável usar o UUID da versão 4.
  • Verifique se as credenciais usadas para todas as solicitações de Place Autocomplete, Place Details e Address Validation em uma sessão pertencem ao mesmo projeto do Console do Cloud.
  • Transmita um token de sessão exclusivo para cada sessão nova. Se você usar o mesmo token para mais de uma sessão, cada solicitação será faturada individualmente.

Corpo da solicitação

O corpo da solicitação precisa estar vazio.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de Place.