Place (beta)

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Classe Place

Classe google.maps.places.Place

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

Ao usar v=beta, é possível chamar const {Place} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

Place
Place(options)
Parâmetros:
findPlaceFromPhoneNumber
findPlaceFromPhoneNumber(request)
Parâmetros:
Valor de retorno: Promise<{places:Array<Place>}>
Pesquisa um lugar com base no número de telefone fornecido. Retorna uma matriz devido a casos raros em que vários lugares podem compartilhar um número de telefone.
findPlaceFromQuery
findPlaceFromQuery(request)
Parâmetros:
Valor de retorno: Promise<{places:Array<Place>}>
Pesquisa um lugar com base na consulta de texto fornecida. Retorna uma matriz devido aos casos em que a consulta é um pouco ambígua e mais de um lugar é retornado. Esse método não se destina a pesquisas em que vários resultados são esperados.
addressComponents
Tipo:Array<AddressComponent> optional
A coleção de componentes de endereço desse local. Objeto vazio se não houver dados de endereço conhecidos. undefined: se os dados do endereço não forem chamados do servidor.
adrFormatAddress
Tipo: string optional
A representação do endereço do lugar no microformato adr.
attributions
Tipo:Array<Attribution> optional
Texto de atribuição a ser exibido para esse resultado de lugar.
businessStatus
Tipo:BusinessStatus optional
O status operacional do local. null: se não houver status conhecido. undefined se os dados de status não foram carregados do servidor.
displayName
Tipo: string optional
O nome de exibição do local. null: se não houver nome. undefined se os dados de nome não foram carregados do servidor.
formattedAddress
Tipo:string optional
O endereço completo do local.
googleMapsURI
Tipo: string optional
URL da página oficial do Google desse local. Essa é a página de propriedade do Google que contém as melhores informações disponíveis sobre o lugar.
hasCurbsidePickup
Tipo: boolean optional
Se um lugar tem drive-thru. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
hasDelivery
Tipo: boolean optional
Se um lugar tem serviço de entrega. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
hasDineIn
Tipo: boolean optional
Se um lugar comeu no local. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
hasTakeout
Tipo: boolean optional
Se um lugar tem opções de retirada. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
hasWheelchairAccessibleEntrance
Tipo:boolean optional
Se um lugar tem uma entrada acessível para cadeirantes. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
icon
Tipo: string optional
URL de um recurso de imagem que pode ser usado para representar a categoria desse local.
iconBackgroundColor
Tipo:string optional
Código de cor HEX padrão para a categoria do lugar.
id
Tipo: string
O ID de lugar exclusivo.
internationalPhoneNumber
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 (+).
isReservable
Tipo:boolean optional
Se um lugar pode ser reservado. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
location
Tipo: LatLng optional
A posição do lugar.
nationalPhoneNumber
Tipo: string optional
O número de telefone do local, formatado de acordo com a convenção regional do número.
openingHours
Tipo:OpeningHours optional
photos
Tipo: Array<Photo> optional
Fotos deste lugar. A coleção conterá até dez objetos Photo.
plusCode
Tipo:PlusCode optional
priceLevel
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 como:
  • 0: sem custo financeiro
  • 1: Barato
  • 2: moderada
  • 3: caro
  • 4: muito caro
rating
Tipo: number optional
Uma classificação, entre 1,0 e 5,0, com base em avaliações do usuário do lugar.
requestedLanguage
Tipo: string optional
O idioma solicitado para esse lugar.
requestedRegion
Tipo: string optional
Região solicitada para esse lugar.
reviews
Tipo: Array<Review> optional
Uma lista de avaliações desse lugar.
servesBeer
Tipo:boolean optional
Se um lugar serve cerveja. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
servesBreakfast
Tipo:boolean optional
Se um lugar serve café da manhã. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
servesBrunch
Tipo: boolean optional
Se um lugar serve brunch. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
servesDinner
Tipo:boolean optional
Se um lugar serve jantar. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
servesLunch
Tipo:boolean optional
Se um lugar serve almoço. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
servesVegetarianFood
Tipo:boolean optional
Se um lugar serve comida vegetariana. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
servesWine
Tipo: boolean optional
Se um lugar serve vinho. Retorna "true" ou "false" se o valor for conhecido. Retorna "null" se o valor for desconhecido. Retorna "undefined" se esse campo ainda não tiver sido solicitado.
svgIconMaskURI
Tipo:string optional
URI para o recurso de máscara de imagem SVG que pode ser usado para representar a categoria de um lugar.
types
Tipo: Array<string> optional
Uma matriz de tipos para este lugar (por exemplo, ["political", "locality"] ou ["restaurant", "establishment"]).
userRatingsCount
Tipo: number optional
O número de avaliações dos usuários que contribuíram para os Place.rating deste lugar.
utcOffsetMinutes
Tipo: number optional
O deslocamento em relação ao UTC do fuso horário atual do lugar, em minutos. Por exemplo, o horário padrão da Austrália Oriental (GMT+10) no horário de verão é 11 horas à frente do UTC. Portanto, o utc_offset_minutes será 660. Para fusos horários posteriores ao UTC, o deslocamento é negativo. Por exemplo, utc_offset_minutes é -60 para Cabo Verde.
viewport
Tipo: LatLngBounds optional
Janela de visualização preferencial para exibir esse lugar no mapa.
websiteURI
Tipo: string optional
O site oficial do lugar, como a página inicial de uma empresa.
fetchFields
fetchFields(options)
Parâmetros:
Valor de retorno: Promise<{place:Place}>
getNextOpeningTime
getNextOpeningTime([date])
Parâmetros:
  • date: Date optional
Valor de retorno: Promise<Date optional>
Calcula o carimbo de data/hora (em milissegundos desde o período, adequado para uso com new Date()) representando o próximo OpeningHoursTime. Retornará indefinido se os dados forem insuficientes para calcular o resultado ou se o local não estiver operacional.
isOpen
isOpen([date])
Parâmetros:
  • dateDate optional agora é o padrão.
Valor de retorno: Promise<boolean optional>
Verifique se o lugar está aberto na data e hora especificada. Resolve com undefined se os dados conhecidos do local forem insuficientes para calcular isso, por exemplo, se o horário de funcionamento não estiver registrado.

interface PlaceOptions.

Interface google.maps.places.PlaceOptions

Opções para construir um lugar.

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

id
Tipo: string
O ID de lugar exclusivo.
requestedLanguage optional
Tipo: string optional
Um identificador de idioma para o idioma em que os detalhes devem ser retornados. Consulte a lista de idiomas compatíveis.
requestedRegion optional
Tipo: string optional
Um código de região da região do usuário. Isso pode afetar as fotos que podem ser devolvidas e, possivelmente, outras coisas. O código de região aceita um valor de ccTLD ("domínio de nível superior") de dois caracteres. 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 "Reino Unido da Grã-Bretanha e Irlanda do Norte").

Classe AddressComponent

Classe google.maps.places.AddressComponent

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

Ao usar v=beta, é possível chamar const {AddressComponent} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

longText
Tipo: string optional
O texto completo do componente de endereço.
shortText
Tipo:string optional
É o texto curto, abreviado, do componente de endereço fornecido.
types
Tipo: Array<string>
Uma matriz de strings que indica o tipo deste componente de endereço. Veja uma lista de tipos válidos aqui.

Classe de atribuição

Classe google.maps.places.Attribution

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

Ao usar v=beta, é possível chamar const {Attribution} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

provider
Tipo:string optional
Texto de atribuição a ser exibido para esse resultado de lugar.
providerURI
Tipo:string optional

Interface FetchFieldsRequest.

Interface google.maps.places.FetchFieldsRequest

Opções para buscar campos do lugar.

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

fields
Tipo:Array<string>
Lista de campos a serem buscados.
sessionToken optional
Referência exclusiva usada para agrupar a solicitação de detalhes com uma sessão de preenchimento automático.

Classe OpeningHours

Classe google.maps.places.OpeningHours

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

Ao usar v=beta, é possível chamar const {OpeningHours} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

periods
Períodos de abertura em cada dia da semana, a partir de domingo, em ordem cronológica. Não inclui dias em que o local não está aberto.
weekdayDescriptions
Tipo: Array<string>
Uma matriz de sete strings representando os horários de funcionamento formatados para cada dia da semana. O serviço do Places vai formatar e localizar o horário de funcionamento de acordo com o idioma atual. A ordem dos elementos nessa matriz depende do idioma. Alguns idiomas começam a semana na segunda-feira, enquanto outros começam no domingo.

Classe OpeningHoursPeriod

Classe google.maps.places.OpeningHoursPeriod

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

Ao usar v=beta, é possível chamar const {OpeningHoursPeriod} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

close
Tipo:OpeningHoursPoint optional
O horário de fechamento do local.
open
O horário de abertura do lugar.

Classe OpeningHoursPoint

Classe google.maps.places.OpeningHoursPoint

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

Ao usar v=beta, é possível chamar const {OpeningHoursPoint} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

day
Tipo:number
O dia da semana, como um número no intervalo [0, 6], começando no domingo. Por exemplo, 2 significa terça-feira.
hour
Tipo: number
A hora de OpeningHoursPoint.time como um número, no intervalo [0, 23]. Isso será informado no fuso horário do lugar.
minute
Tipo:number
O minuto de OpeningHoursPoint.time como um número, no intervalo [0, 59]. Isso será informado no fuso horário do lugar.

Classe Photo

Classe google.maps.places.Photo

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

Ao usar v=beta, é possível chamar const {Photo} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

attributions
Texto de atribuição a ser exibido para esta foto.
heightPx
Tipo:number
É a altura da foto em pixels.
widthPx
Tipo: number
É a largura da foto em pixels.
getURI
getURI([options])
Parâmetros:
Valor de retorno: string
Retorna o URL de imagem correspondente às opções especificadas.

Classe PhotoAssignment

Classe google.maps.places.PhotoAttribution

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

Ao usar v=beta, é possível chamar const {PhotoAttribution} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

author
Tipo: string
Texto de atribuição a ser exibido para esse resultado de foto.
authorURI
Tipo:string optional

Classe PlusCode

Classe google.maps.places.PlusCode

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

Ao usar v=beta, é possível chamar const {PlusCode} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

compoundCode
Tipo: string optional
É um Plus Code com 1/8.000o de um grau 1/8000o de uma área de grau onde os primeiros quatro caracteres (o código de área) são soltos e substituídos por uma descrição de região. Por exemplo, "9G8F+5 W Zurique, Suíça".
globalCode
Tipo:string optional
Um Plus Code com 1/8.000o de um grau por 1/8000o de uma área de grau. Por exemplo, "8FVC9G8F+5 W".

Classe de avaliação

Classe google.maps.places.Review

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

Ao usar v=beta, é possível chamar const {Review} = await google.map.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.

author
Tipo: string optional
É o nome do avaliador.
authorPhotoURI
Tipo:string optional
Um URL para a imagem de perfil do espectador.
authorURI
Tipo: string optional
Um URL para o perfil do avaliador.
publishTime
Tipo: Date optional
rating
Tipo: number optional
É a nota dessa avaliação, um número entre 1 e 5, inclusive.
relativePublishTimeDescription
Tipo: string optional
É uma string de horário recente formatado que expressa 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, "há 1 mês".
text
Tipo:string optional
O texto de uma avaliação.
textLanguageCode
Tipo: string optional
Um código de idioma IETF indicando o idioma em que a avaliação foi escrita. Esse código inclui apenas a tag do idioma principal sem nenhuma tag secundária que indique o país ou a região. Por exemplo, todas as avaliações em inglês estão marcadas como 'en' em vez de "en-AU" ou "en-UK".