Places Service

Classe PlacesService

Classe google.maps.places.PlacesService

Contém métodos relacionados à pesquisa de lugares e à recuperação de detalhes sobre um lugar.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

PlacesService
PlacesService(attrContainer)
Parâmetros:
Cria uma nova instância do PlacesService que renderiza atribuições no contêiner especificado.
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request, callback)
Parâmetros:
Valor de retorno:nenhum
Recupera uma lista de lugares com base em um número de telefone. Na maioria dos casos, haverá apenas um item na lista de resultados. No entanto, se a solicitação for ambígua, mais de um resultado poderá ser retornado. Os PlaceResults transmitidos ao callback são subconjuntos de uma PlaceResult completa. Seu app pode receber um PlaceResult mais detalhado para cada lugar chamando PlacesService.getDetails e transmitindo PlaceResult.place_id para o lugar desejado.
findPlaceFromQuery
findPlaceFromQuery(request, callback)
Parâmetros:
Valor de retorno: nenhum
Recupera uma lista de lugares com base em uma string de consulta. Na maioria dos casos, haverá apenas um item na lista de resultados. No entanto, se a solicitação for ambígua, mais de um resultado poderá ser retornado. Os PlaceResults transmitidos ao callback são subconjuntos de uma PlaceResult completa. Seu app pode receber um PlaceResult mais detalhado para cada lugar chamando PlacesService.getDetails e transmitindo PlaceResult.place_id para o lugar desejado.
getDetails
getDetails(request, callback)
Parâmetros:
Valor de retorno:nenhum
Recupera detalhes sobre o lugar identificado por placeId.
nearbySearch
nearbySearch(request, callback)
Parâmetros:
Valor de retorno:nenhum
Recupera uma lista de lugares próximos a um local específico, com base na palavra-chave ou no tipo. O local precisa ser sempre especificado transmitindo um parâmetro LatLngBounds ou location e radius. Os PlaceResults transmitidos ao callback são subconjuntos do PlaceResult completo. Seu app pode receber uma PlaceResult mais detalhada para cada lugar enviando uma solicitação do Place Details transmitindo o PlaceResult.place_id para o lugar desejado. O objeto PlaceSearchPagination pode ser usado para buscar páginas adicionais de resultados (null se essa for a última página de resultados ou se houver apenas uma página de resultados).
textSearch
textSearch(request, callback)
Parâmetros:
Valor de retorno:nenhum
Recupera uma lista de lugares com base em uma string de consulta (por exemplo, "pizza em Nova York" ou "lojas de sapato perto de Ottawa"). Os parâmetros de localização são opcionais. Quando o local é especificado, os resultados são direcionados apenas para resultados próximos, e não restritos a lugares dentro da área. Use textSearch quando quiser pesquisar lugares usando uma string arbitrária e, nos casos em que você não quiser restringir os resultados da pesquisa a um local específico. O objeto PlaceSearchPagination pode ser usado para buscar páginas adicionais de resultados (null se essa for a última página de resultados ou se houver apenas uma página de resultados).

Interface PlaceDetailsRequest

Interface google.maps.places.PlaceDetailsRequest

Uma consulta de detalhes do lugar a ser enviada ao PlacesService.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

placeId
Tipo: string
O ID de lugar do local para o qual os detalhes estão sendo solicitados.
fields optional
Tipo:Array<string> optional
Campos a serem incluídos na resposta de detalhes, que será cobrada. Se nenhum campo for especificado ou ['ALL'] for transmitido, todos os campos disponíveis serão retornados e cobrados. Isso não é recomendado para implantações de produção. Para uma lista de campos, consulte PlaceResult. Campos aninhados podem ser especificados com caminhos de ponto (por exemplo, "geometry.location").
language optional
Tipo: string optional
Um identificador de idioma para o idioma em que os detalhes precisam ser retornados. Consulte a lista de idiomas compatíveis.
region optional
Tipo:string optional
Um código regional da região do usuário. Isso pode afetar as fotos que podem ser retornadas e possivelmente outros fatores. O código da região aceita um valor de dois caracteres para ccTLD ("top-level domain"). A maioria dos códigos ccTLD é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" (.co.uk), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade do "Reino Unido da Grã-Bretanha e Irlanda do Norte").
sessionToken optional
Referência exclusiva usada para agrupar a solicitação de detalhes com uma sessão de preenchimento automático.

Interface FindPlaceFromPhoneNumberRequest

Interface google.maps.places.FindPlaceFromPhoneNumberRequest

Um local da solicitação de pesquisa de texto a ser enviado para PlacesService.findPlaceFromPhoneNumber.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

fields
Tipo:Array<string>
Campos a serem incluídos na resposta, que serão cobrados. Se ['ALL'] for transmitido, todos os campos disponíveis serão retornados e cobrados. Isso não é recomendado para implantações de produção. Para uma lista de campos, consulte PlaceResult. Campos aninhados podem ser especificados com caminhos de ponto (por exemplo, "geometry.location").
phoneNumber
Tipo:string
O número de telefone do lugar a ser pesquisado. O formato precisa ser E.164.
language optional
Tipo: string optional
Um identificador de idioma para o idioma em que os nomes e endereços precisam ser retornados, quando possível. Consulte a lista de idiomas compatíveis.
locationBias optional
Tipo: LocationBias optional
O viés usado ao pesquisar o lugar. O resultado será tendencioso, mas não restrito, para o LocationBias especificado.

Interface FindPlaceFromQueryRequest

Interface google.maps.places.FindPlaceFromQueryRequest

Um local da solicitação de pesquisa de texto a ser enviado para PlacesService.findPlaceFromQuery.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

fields
Tipo: Array<string>
Campos a serem incluídos na resposta, que serão cobrados. Se ['ALL'] for transmitido, todos os campos disponíveis serão retornados e cobrados. Isso não é recomendado para implantações de produção. Para uma lista de campos, consulte PlaceResult. Campos aninhados podem ser especificados com caminhos de ponto (por exemplo, "geometry.location").
query
Tipo: string
A consulta da solicitação. Por exemplo, o nome ou endereço de um lugar.
language optional
Tipo:string optional
Um identificador de idioma para o idioma em que os nomes e endereços precisam ser retornados, quando possível. Consulte a lista de idiomas compatíveis.
locationBias optional
Tipo:LocationBias optional
O viés usado ao pesquisar o lugar. O resultado será tendencioso, mas não restrito, para o LocationBias especificado.

Interface PlaceSearchRequest

Interface google.maps.places.PlaceSearchRequest

Uma consulta de pesquisa de lugar a ser enviada ao PlacesService.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

bounds optional
Os limites em que pesquisar lugares. location e radius serão ignorados se bounds for definido.
keyword optional
Tipo: string optional
Um termo que corresponde a todos os campos disponíveis, incluindo, mas não se limitando a, nome, tipo e endereço, bem como avaliações de clientes e outros conteúdos de terceiros.
language optional
Tipo: string optional
Um identificador de idioma para o idioma em que os nomes e endereços precisam ser retornados, quando possível. Consulte a lista de idiomas compatíveis.
location optional
Tipo: LatLng|LatLngLiteral optional
O local ao redor do qual pesquisar lugares.
maxPriceLevel optional
Tipo: number optional
Restringe os resultados apenas aos lugares no nível de preço especificado ou inferior. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro), inclusive. Se especificado, precisa ser maior ou igual a minPrice .
minPriceLevel optional
Tipo: number optional
Restringe os resultados apenas a lugares no nível de preço especificado ou superior. Valores válidos estão no intervalo de 0 (mais barato) a 4 (mais caro), inclusive. Precisa ser menor ou igual a maxPrice, se especificado.
name optional
Tipo:string optional
É equivalente a keyword. Os valores nesse campo são combinados com os valores no campo keyword e transmitidos como parte da mesma string de pesquisa.
openNow optional
Tipo:boolean optional
Restringe os resultados apenas aos lugares que estão abertos no momento.
radius optional
Tipo: number optional
A distância do local especificado em que você quer pesquisar lugares, em metros. O valor máximo permitido é 50.000.
rankBy optional
Tipo:RankBy optional
Especifica o método de classificação a ser usado ao retornar resultados. Quando rankBy é definido como DISTANCE, é necessário especificar um location, mas não é possível especificar um radius ou bounds.
type optional
Tipo: string optional
Pesquisa locais do tipo especificado. O tipo é traduzido para o idioma local do local de destino da solicitação e usado como uma string de consulta. Se uma consulta também é fornecida, ela é concatenada com a string de tipo localizada. Os resultados de um tipo diferente são descartados da resposta. Use este campo para realizar pesquisas categóricas independentes de idioma e região. Veja os tipos válidos aqui.

Interface TextSearchRequest

Interface google.maps.places.TextSearchRequest

Uma solicitação de pesquisa de texto a ser enviada para o PlacesService.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

bounds optional
Limites usados para polarizar os resultados ao pesquisar lugares (opcional). location e radius serão ignorados se bounds for definido. Os resultados não serão restritos aos que estão dentro desses limites, mas os resultados dentro deles terão uma classificação mais alta.
language optional
Tipo: string optional
Um identificador de idioma para o idioma em que os nomes e endereços precisam ser retornados, quando possível. Consulte a lista de idiomas compatíveis.
location optional
Tipo: LatLng|LatLngLiteral optional
O centro da área usado para influenciar os resultados ao pesquisar lugares.
query optional
Tipo:string optional
O termo de consulta da solicitação. Por exemplo, o nome de um lugar ('Torre Eiffel'), uma categoria seguida do nome de um local ('pizza em São Paulo') ou o nome de um lugar seguido por um desambiguador de localização ('Starbucks de Sydney').
radius optional
Tipo: number optional
O raio da área usada para influenciar os resultados ao pesquisar lugares, em metros.
region optional
Tipo: string optional
Um código de região para os resultados do viés. O código da região aceita um valor de dois caracteres para ccTLD ("top-level domain"). A maioria dos códigos ccTLD é idêntica aos códigos ISO 3166-1, com algumas exceções notáveis. Por exemplo, o ccTLD do Reino Unido é "uk" (.co.uk), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade do "Reino Unido da Grã-Bretanha e Irlanda do Norte").
type optional
Tipo:string optional
Pesquisa locais do tipo especificado. O tipo é traduzido para o idioma local do local de destino da solicitação e usado como uma string de consulta. Se uma consulta também é fornecida, ela é concatenada com a string de tipo localizada. Os resultados de um tipo diferente são descartados da resposta. Use este campo para realizar pesquisas categóricas independentes de idioma e região. Veja os tipos válidos aqui.

Constantes de RankBy

Constantes google.maps.places.RankBy

Opções de classificação para um PlaceSearchRequest.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

DISTANCE As classificações colocam os resultados por distância do local.
PROMINENCE Classificações de resultados por proeminência.

LocationBias: typedef

google.maps.places.LocationBias typedef

Um LocationBias representa um limite flexível ou uma dica a ser usada ao pesquisar lugares. Os resultados podem vir de fora da área especificada. Para usar o endereço IP atual do usuário como um viés, a string "IP_BIAS" pode ser especificada. Observação: se você usar um Circle, o centro e o raio precisarão ser definidos.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string

LocationRestriction tipo de defesa

google.maps.places.LocationRestriction typedef

Uma LocationRestriction representa um limite restrito a ser usado ao pesquisar lugares.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

LatLngBounds|LatLngBoundsLiteral

Constantes de PlacesServiceStatus

Constantes google.maps.places.PlacesServiceStatus

O status retornado pelo PlacesService na conclusão das pesquisas. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'OK' ou google.maps.places.PlacesServiceStatus.OK.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

INVALID_REQUEST esta solicitação é inválida.
NOT_FOUND O lugar referenciado não foi encontrado.
OK a resposta contém um resultado válido.
OVER_QUERY_LIMIT O aplicativo ultrapassou sua cota de solicitações.
REQUEST_DENIED O aplicativo não tem permissão para usar o PlacesService.
UNKNOWN_ERROR Não foi possível processar a solicitação PlacesService devido a um erro de servidor. Se você tentar novamente, a solicitação poderá ser bem-sucedida.
ZERO_RESULTS nenhum resultado foi encontrado para a solicitação.

Interface do PlaceSearchPagination

Interface google.maps.places.PlaceSearchPagination

Um objeto usado para buscar outras páginas de resultados do Places.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

hasNextPage
Tipo:boolean
Indica se mais resultados estão disponíveis. true quando houver uma página de resultados adicionais.
nextPage
nextPage()
Parâmetros: nenhum
Valor de retorno: nenhum
Busca a próxima página de resultados. Usa a mesma função de callback fornecida para a primeira solicitação de pesquisa.

Interface PlaceResult

Interface google.maps.places.PlaceResult

Define informações sobre um lugar.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

address_components optional
A coleção de componentes de endereço desse lugar. Disponível apenas com PlacesService.getDetails.
adr_address optional
Tipo:string optional
A representação do endereço do lugar no microformato do adr. Disponível apenas com PlacesService.getDetails.
aspects optional
Tipo: Array<PlaceAspectRating> optional
Os aspectos classificados deste lugar, com base nas avaliações de usuários do Google e da Zagat. As classificações estão em uma escala de 0 a 30.
business_status optional
Tipo:BusinessStatus optional
Uma sinalização que indica o status operacional do lugar, se for uma empresa (indica se o lugar está operacional ou fechado temporária ou permanentemente). Se não houver dados disponíveis, a sinalização não está presente nas respostas de pesquisa ou de detalhes.
formatted_address optional
Tipo: string optional
O endereço completo do lugar.
formatted_phone_number optional
Tipo: string optional
O número de telefone do Lugar, formatado de acordo com a convenção regional de números e números. Disponível apenas com PlacesService.getDetails.
geometry optional
Tipo:PlaceGeometry optional
As informações relacionadas à geometria do local.
html_attributions optional
Tipo:Array<string> optional
Texto de atribuição a ser exibido para esse resultado do local. Os html_attributions disponíveis sempre são retornados, independentemente do que fields foi solicitado e precisam ser exibidos.
icon optional
Tipo:string optional
URL para um recurso de imagem que pode ser usado para representar a categoria do lugar.
icon_background_color optional
Tipo:string optional
Cor de fundo para usar com um ícone do Place' Consulte também PlaceResult.icon_mask_base_uri.
icon_mask_base_uri optional
Tipo:string optional
Um URL truncado para uma máscara de ícone. Acesse diferentes tipos de ícones anexando uma extensão de arquivo ao final (por exemplo, .svg ou .png).
international_phone_number optional
Tipo:string optional
O número de telefone do lugar no formato internacional. O formato internacional inclui o código do país e é prefixado pelo sinal de mais (+). Disponível apenas com PlacesService.getDetails.
name optional
Tipo: string optional
O nome do lugar. Observação: no caso de lugares inseridos pelo usuário, este é o texto bruto, conforme digitado pelo usuário. Tenha cuidado ao usar esses dados, porque usuários maliciosos podem tentar usá-los como vetor para ataques de injeção de código (consulte http://en.wikipedia.org/wiki/Code_injection).
opening_hours optional
Tipo:PlaceOpeningHours optional
Define quando o lugar abre ou fecha.
permanently_closed optional
Tipo:boolean optional
Uma sinalização que indica se o lugar está fechado permanentemente ou temporariamente. Se o lugar estiver operacional ou se não houver dados disponíveis, a sinalização estará ausente na resposta.
photos optional
Tipo: Array<PlacePhoto> optional
Fotos deste lugar. A coleção conterá até 10 objetos PlacePhoto.
place_id optional
Tipo: string optional
Um identificador exclusivo do lugar.
plus_code optional
Tipo: PlacePlusCode optional
Define códigos de local aberto ou "códigos Plus" para o local.
price_level optional
Tipo: number optional
O nível de preço do local, em uma escala de 0 a 4. Os níveis de preço são interpretados da seguinte maneira:
  • 0: sem custo financeiro
  • 1: barato
  • 2: moderado
  • 3: caro
  • 4: muito caro
rating optional
Tipo:number optional
Uma classificação, entre 1,0 e 5,0, com base nos comentários do usuário sobre esse lugar.
reviews optional
Tipo:Array<PlaceReview> optional
Uma lista de avaliações do lugar. Disponível apenas com PlacesService.getDetails.
types optional
Tipo:Array<string> optional
Uma matriz de tipos de para este lugar (por exemplo, ["political", "locality"] ou ["restaurant", "establishment"]).
url optional
Tipo: string optional
URL da página oficial do Google desse local. Essa é a página do Google que contém as melhores informações disponíveis sobre o local. Disponível apenas com PlacesService.getDetails.
user_ratings_total optional
Tipo: number optional
O número de classificações do usuário que contribuíram para o PlaceResult.rating desse lugar.
utc_offset optional
Tipo: number optional
A diferença do fuso horário atual em relação ao UTC, em minutos. Por exemplo, Sydney, Austrália, em horário de verão, fica 11 horas à frente de UTC, então utc_offset é 660. Para fusos horários atrás de UTC, o deslocamento é negativo. Por exemplo, a utc_offset é -60 para o Cabo Verde. Disponível apenas com PlacesService.getDetails.
utc_offset_minutes optional
Tipo: number optional
A diferença do fuso horário atual em relação ao UTC, em minutos. Por exemplo, Sydney, Austrália, em horário de verão, fica 11 horas à frente de UTC, então utc_offset_minutes é 660. Para fusos horários atrás de UTC, o deslocamento é negativo. Por exemplo, a utc_offset_minutes é -60 para o Cabo Verde. Disponível apenas com PlacesService.getDetails.
vicinity optional
Tipo:string optional
O endereço simplificado do lugar, incluindo o nome e o número da rua e a localidade, mas não a província/estado, o CEP ou o país. Por exemplo, o escritório do Google em Sydney, Austrália, tem um valor de vicinidade de "48 Pirrama Road, Pyrmont". Disponível apenas com PlacesService.getDetails.
website optional
Tipo: string optional
O site oficial do lugar, como a página inicial de uma empresa. Disponível apenas com PlacesService.getDetails.

Interface PlaceAspectRating

Interface google.maps.places.PlaceAspectRating

Define informações sobre um aspecto do lugar que os usuários avaliaram.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

rating
Tipo:number
É a classificação desse aspecto. Para avaliações individuais, esse número é um número inteiro de 0 a 3. Para classificações agregadas de um lugar, é um número inteiro de 0 a 30.
type
Tipo: string
É o tipo de aspecto. Por exemplo, "food", "decor", "service" ou "overall".

Constantes de BusinessStatus

Constantes google.maps.places.BusinessStatus

O status operacional do lugar, se for uma empresa, será retornado em um PlaceResult (indica se o lugar está operacional ou fechado de forma temporária ou permanente). Especifique-os por valor ou o nome da constante (por exemplo: 'OPERATIONAL' ou google.maps.places.BusinessStatus.OPERATIONAL).

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

CLOSED_PERMANENTLY A empresa está fechada permanentemente.
CLOSED_TEMPORARILY A empresa está fechada temporariamente.
OPERATIONAL A empresa está funcionando normalmente.

Interface PlaceGeo

Interface google.maps.places.PlaceGeometry

Define informações sobre a geometria de um lugar.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

location optional
Tipo: LatLng optional
A posição do lugar.
viewport optional
Tipo: LatLngBounds optional
A janela de visualização preferencial ao exibir este lugar em um mapa. Esta propriedade será null se a janela de visualização preferencial do lugar não for conhecida. Disponível apenas com PlacesService.getDetails.

Interface PlaceOpeningHours

Interface google.maps.places.PlaceOpeningHours

Define informações sobre o horário de funcionamento de um lugar.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

open_now optional
Tipo: boolean optional
Indica se o lugar está aberto no momento.
periods optional
Períodos de abertura para cada dia da semana, a partir de domingo, em ordem cronológica. Os dias em que o local não está aberto não são incluídos. Disponível apenas com PlacesService.getDetails.
weekday_text optional
Tipo: Array<string> optional
Uma matriz de sete strings que representam o horário de abertura formatado para cada dia da semana. O Serviço do Places vai formatar e localizar o horário de funcionamento corretamente para o idioma atual. A ordem dos elementos nessa matriz depende do idioma. Alguns idiomas iniciam a semana na segunda-feira e outros iniciam no domingo. Disponível apenas com PlacesService.getDetails. Outras chamadas podem retornar uma matriz vazia.
isOpen
isOpen([date])
Parâmetros:
  • date: Date optional
Valor de retorno:boolean|undefined
Verifique se o lugar está aberto agora (quando nenhuma data foi passada) ou na data especificada. Se esse lugar não tem PlaceResult.utc_offset_minutes ou PlaceOpeningHours.periods, undefined é retornado (PlaceOpeningHours.periods só está disponível via PlacesService.getDetails). Esse método não considera horários excepcionais, como o horário de funcionamento durante o feriado.

Interface PlaceOpeningHoursPeriod

Interface google.maps.places.PlaceOpeningHoursPeriod

Define informações estruturadas sobre o horário de funcionamento de um lugar. Observação: se um local estiver sempre aberto, a seção close não aparecerá na resposta. Os clientes podem confiar que sempre aberto seja representado como um período open que contém day com valor 0 e time com valor "0000", e nenhum close.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

open
É o horário de abertura do local.
close optional
Tipo:PlaceOpeningHoursTime optional
O horário de fechamento do local.

Interface PlaceOpeningHoursTime

Interface google.maps.places.PlaceOpeningHoursTime

Define quando um lugar abre ou fecha.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

day
Tipo: number
Os dias da semana, como um número no intervalo [0, 6], a partir de domingo. Por exemplo, 2 significa terça-feira.
hours
Tipo:number
As horas de PlaceOpeningHoursTime.time como um número, no intervalo [0, 23]. Isso será informado no fuso horário do local.
minutes
Tipo: number
Os minutos da PlaceOpeningHoursTime.time como um número, no intervalo [0, 59]. Isso será informado no fuso horário do local.
time
Tipo:string
A hora do dia no formato de 24 horas "hhmm" Os valores estão no intervalo ["0000", "2359"]. O horário será o fuso horário do lugar.
nextDate optional
Tipo:number optional
O carimbo de data/hora (em milissegundos desde o período, adequado para uso com new Date()) que representa a próxima ocorrência deste PlaceOpeningHoursTime. Ele é calculado a partir do PlaceOpeningHoursTime.day da semana, do PlaceOpeningHoursTime.time e do PlaceResult.utc_offset_minutes. Se PlaceResult.utc_offset_minutes for undefined, então nextDate será undefined.

Interface do PlacePlusCode

Interface google.maps.places.PlacePlusCode

Define códigos de localização aberta ou códigos de adição para um lugar. Os Plus Codes podem ser usados para substituir endereços em lugares que não existem, ou seja, quando os edifícios não estão numerados ou as ruas não têm nome.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

global_code
Tipo:string
Um Plus Code com 1/8000o de grau de um grau 1/8000 de uma área de grau. Por exemplo, "8FVC9G8F+5W".
compound_code optional
Tipo:string optional
Um código Plus com 1/8000o de grau 1/8000o de área de grau em que os primeiros quatro caracteres (o código de área) são descartados e substituídos por uma descrição de localidade. Por exemplo, "9G8F+5W Zurich, Switzerland". Se não for encontrada uma localidade adequada que possa encurtar o código, esse campo será omitido.

Interface PlacePhoto

Interface google.maps.places.PlacePhoto

Representa um elemento de foto de um lugar.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

height
Tipo: number
Indica a altura da foto em pixels.
html_attributions
Tipo: Array<string>
Texto de atribuição a ser exibido para esta foto.
width
Tipo:number
É a largura da foto em pixels.
getUrl
getUrl([opts])
Parâmetros:
Valor de retorno: string
Retorna o URL da imagem correspondente às opções especificadas.

Interface PhotoOptions

Interface google.maps.places.PhotoOptions

Define as opções de solicitação de foto.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

maxHeight optional
Tipo:number optional
É a altura máxima em pixels da imagem retornada.
maxWidth optional
Tipo: number optional
A largura máxima em pixels da imagem retornada.

Interface PlaceReview.

Interface google.maps.places.PlaceReview

Representa uma única avaliação de um lugar.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

author_name
Tipo: string
É o nome do avaliador.
language
Tipo:string
Um código de idioma IETF indicando o idioma em que a avaliação é escrita. Esse código inclui apenas a tag do idioma principal sem nenhuma tag secundária indicando país ou região. Por exemplo, todas as avaliações em inglês são marcadas como 'en' em vez de 'en-AU' ou 'en-UK'.
profile_photo_url
Tipo: string
Um URL para a imagem de perfil do destinatário.
relative_time_description
Tipo:string
Uma string de horário recente formatado, expressando o horário da revisão em relação ao horário atual em um formato adequado ao idioma e ao país. Por exemplo: "a month ago"
text
Tipo: string
É o texto de uma avaliação.
time
Tipo: number
Carimbo de data/hora da avaliação, expresso em segundos desde época.
aspects optional
Tipo:Array<PlaceAspectRating> optional
Os aspectos classificados pela avaliação. As classificações em uma escala de 0 a 3.
author_url optional
Tipo:string optional
Um URL para o perfil do avaliador. Esse valor será undefined quando o perfil do revisor estiver indisponível.
rating optional
Tipo:number optional
A classificação dessa avaliação, um número entre 1,0 e 5,0 (incluso).