Place (beta)

Classe Place

Classe google.maps.places.Place

Aviso: disponível apenas no canal v=beta.

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.

Construtor
Place	Place(options) Parâmetros: options:  PlaceOptions

Métodos estáticos
findPlaceFromPhoneNumber	findPlaceFromPhoneNumber(request) Parâmetros: request: FindPlaceFromPhoneNumberRequest a solicitação que contém o número de telefone e os campos solicitados. 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: request: FindPlaceFromQueryRequest a solicitação que contém a consulta de texto e os campos solicitados. 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.

Propriedades
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.

Métodos
fetchFields	fetchFields(options) Parâmetros: options:  FetchFieldsRequest 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: 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

Aviso: disponível apenas no canal v=beta.

Opções para construir um lugar.

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

Propriedades
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

Aviso:disponível apenas no canal v=beta.

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.

Propriedades
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

Aviso:disponível apenas no canal v=beta.

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.

Propriedades
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

Aviso: disponível apenas no canal v=beta.

Opções para buscar campos do lugar.

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

Propriedades
fields	Tipo:Array<string> Lista de campos a serem buscados.
sessionToken optional	Tipo:AutocompleteSessionToken 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

Aviso:disponível apenas no canal v=beta.

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.

Propriedades
periods	Tipo:Array<OpeningHoursPeriod> 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

Aviso: disponível apenas no canal v=beta.

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.

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

Classe OpeningHoursPoint

Classe google.maps.places.OpeningHoursPoint

Aviso: disponível apenas no canal v=beta.

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.

Propriedades
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

Aviso: disponível apenas no canal v=beta.

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.

Propriedades
attributions	Tipo:Array<PhotoAttribution> 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.

Métodos
getURI	getURI([options]) Parâmetros: options: PhotoOptions optional Valor de retorno: string Retorna o URL de imagem correspondente às opções especificadas.

Classe PhotoAssignment

Classe google.maps.places.PhotoAttribution

Aviso:disponível apenas no canal v=beta.

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.

Propriedades
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

Aviso: disponível apenas no canal v=beta.

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.

Propriedades
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

Aviso:disponível apenas no canal v=beta.

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.

Propriedades
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".