Place (beta)

Classe Place

Classe google.maps.places.Place

Acesse const {Place} = await google.maps.importLibrary("places") chamando. Consulte Bibliotecas na API Maps JavaScript.
Place
Place(options)
Parâmetros:
BetafindPlaceFromPhoneNumber
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.
BetafindPlaceFromQuery
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.
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:PriceLevel optional
O nível de preço do lugar. Esta propriedade pode retornar qualquer um dos seguintes valores
  • Free
  • Inexpensive
  • Moderate
  • Expensive
  • Very Expensive
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"]).
userRatingCount
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.
BetafetchFields
fetchFields(options)
Parâmetros:
Valor de retorno:  Promise<{place:Place}>
BetagetNextOpeningTime
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.
BetaisOpen
isOpen([date])
Parâmetros:
  • date:  Date 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.
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

Acesse const {AddressComponent} = await google.maps.importLibrary("places") chamando. 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

Acesse const {Attribution} = await google.maps.importLibrary("places") chamando. 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.
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

Acesse const {OpeningHours} = await google.maps.importLibrary("places") chamando. 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

Acesse const {OpeningHoursPeriod} = await google.maps.importLibrary("places") chamando. 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

Acesse const {OpeningHoursPoint} = await google.maps.importLibrary("places") chamando. 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

Acesse const {Photo} = await google.maps.importLibrary("places") chamando. 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

Acesse const {PhotoAttribution} = await google.maps.importLibrary("places") chamando. 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

Acesse const {PlusCode} = await google.maps.importLibrary("places") chamando. 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

Acesse const {Review} = await google.maps.importLibrary("places") chamando. 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".

PriceLevel

google.maps.places.PriceLevel constantes

Enumeração de nível de preço para objetos de lugar.

Acesse const {PriceLevel} = await google.maps.importLibrary("places") chamando. Consulte Bibliotecas na API Maps JavaScript.
EXPENSIVE
FREE
INEXPENSIVE
MODERATE
VERY_EXPENSIVE