Place (beta)

Classe Place

Classe google.maps.places.Place

Acesse chamando const {Place} = await google.maps.importLibrary("places"). 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 a casos em que a consulta é levemente ambígua e mais de um local é retornado. Esse método não se destina a pesquisas em que vários resultados são esperados.
BetasearchByText
searchByText(request)
Parâmetros: 
Valor de retorno:  Promise<{places:Array<Place>}>
Pesquisa de local baseada em consulta de texto.
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 de endereço não tiverem sido chamados no servidor.
adrFormatAddress
Tipo:  string optional
A representação do endereço do local 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 um 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 do nome não tiverem sido 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 do Google com as melhores informações disponíveis sobre o local.
hasCurbsidePickup
Tipo:  boolean optional
Se um lugar tem drive-thru. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
hasDelivery
Tipo:  boolean optional
Se um lugar tem serviço de entrega. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
hasDineIn
Tipo:  boolean optional
Se um lugar jantou no local. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
hasTakeout
Tipo:  boolean optional
se um lugar tem opções de comida para viagem; Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
hasWheelchairAccessibleEntrance
Tipo:  boolean optional
Se um lugar tem uma entrada acessível a pessoas em cadeira de rodas. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
iconBackgroundColor
Tipo:  string optional
O código de cor hexadecimal 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
Indica se um lugar pode ser reservado. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
location
Tipo:  LatLng optional
A posição do local.
nationalPhoneNumber
Tipo:  string optional
o número de telefone do lugar, 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. Essa 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 nas avaliações dos usuários sobre este lugar.
requestedLanguage
Tipo:  string optional
Idioma solicitado para esse lugar.
requestedRegion
Tipo:  string optional
A região solicitada para este lugar.
reviews
Tipo:  Array<Review> optional
Uma lista de avaliações deste lugar.
servesBeer
Tipo:  boolean optional
Se um lugar serve cerveja. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
servesBreakfast
Tipo:  boolean optional
Se um lugar serve café da manhã. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
servesBrunch
Tipo:  boolean optional
Se um lugar serve brunch. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
servesDinner
Tipo:  boolean optional
Se um lugar serve jantar. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
servesLunch
Tipo:  boolean optional
Se um lugar serve almoço. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
servesVegetarianFood
Tipo:  boolean optional
Se um lugar serve comida vegetariana. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi solicitado.
servesWine
Tipo:  boolean optional
Se um lugar serve vinho. Retorna "true" ou "false" se o valor é conhecido. Retorna "nulo" se o valor é desconhecido. Retorna "undefined" se esse campo ainda não foi 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 types para este lugar (por exemplo, ["political", "locality"] ou ["restaurant", "establishment"]).
userRatingCount
Tipo:  number optional
O número de avaliações de usuários que contribuíram para a métrica Place.rating desse lugar.
utcOffsetMinutes
Tipo:  number optional
A diferença do UTC do fuso horário atual do lugar, em minutos. Por exemplo, o horário padrão da Costa Leste da Austrália (GMT+10) no horário de verão está 11 horas à frente do UTC, então utc_offset_minutes será 660. Para fusos horários atrás do UTC, a diferença é negativa. Por exemplo, utc_offset_minutes é -60 para Cabo Verde.
viewport
Tipo:  LatLngBounds optional
A janela de visualização preferida ao exibir este lugar em um 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 a data que representa o próximo OpeningHoursTime. Retorna "undefined" se os dados são insuficientes para calcular o resultado ou o local não é operacional.
BetaisOpen
isOpen([date])
Parâmetros: 
  • date:  Date optional por padrão é "agora".
Valor de retorno:  Promise<boolean optional>
Verifica se o local está aberto na data e hora determinada. Resolve com undefined se os dados conhecidos do local não forem suficientes para calcular isso, por exemplo, se o horário de funcionamento não for registrado.
toJSON
toJSON()
Parâmetros: nenhum
Valor de retorno:  Object um objeto JSON com todas as propriedades solicitadas do lugar.

PlaceOptions

Interface google.maps.places.PlaceOptions

Opções para construir um Place.
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
O código da região do usuário. Isso pode afetar quais fotos podem ser retornadas e possivelmente outros itens. O código regional aceita um valor de dois caracteres ccTLD ("domínio de nível superior"). 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 chamando const {AddressComponent} = await google.maps.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 especificado.
types
Tipo:  Array<string>
Uma matriz de strings que denota o tipo desse componente de endereço. Veja uma lista de tipos válidos aqui.

Classe Attribution

Classe google.maps.places.Attribution

Acesse chamando const {Attribution} = await google.maps.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

FetchFieldsRequest

Interface google.maps.places.FetchFieldsRequest

Opções para buscar campos de lugar.
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

Acesse chamando const {OpeningHours} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
periods
Períodos de funcionamento que abrangem todos os dias da semana, começando no domingo, em ordem cronológica. Não inclui dias em que o lugar não está aberto.
weekdayDescriptions
Tipo:  Array<string>
Uma matriz de sete strings que representam os horários de funcionamento formatados para cada dia da semana. O serviço Places vai formatar e localizar os horários de funcionamento de forma adequada para o idioma atual. A ordem dos elementos nessa matriz depende da linguagem. Alguns idiomas iniciam a semana na segunda-feira e outros no domingo.

Classe OpeningHoursPeriod

Classe google.maps.places.OpeningHoursPeriod

Acesse chamando const {OpeningHoursPeriod} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
close
Tipo:  OpeningHoursPoint optional
A hora de fechamento do lugar.
open
O horário de abertura do local.

Classe OpeningHoursPoint

Classe google.maps.places.OpeningHoursPoint

Acesse chamando const {OpeningHoursPoint} = await google.maps.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

Acesse chamando const {Photo} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
authorAttributions
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 da imagem correspondente às opções especificadas.

Classe AuthorAttribution

Classe google.maps.places.AuthorAttribution

Acesse chamando const {AuthorAttribution} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
displayName
Tipo:  string
Nome do autor para este resultado.
photoURI
Tipo:  string optional
URI da foto do autor para este resultado. Essa opção nem sempre está disponível.
uri
Tipo:  string optional
URI do perfil do autor para este resultado.

Classe PlusCode

Classe google.maps.places.PlusCode

Acesse chamando const {PlusCode} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
compoundCode
Tipo:  string optional
Um Plus Code com 1/8.000 de grau por 1/8.000 de área de grau em que os quatro primeiros caracteres (o código de área) são inseridos e substituídos por uma descrição da região administrativa. Por exemplo, "9G8F+5W Zurique, Suíça".
globalCode
Tipo:  string optional
Um plus code com 1/8.000 de grau por 1/8.000 da área de graus. Por exemplo, "8FVC9G8F+5W".

Classe Review

Classe google.maps.places.Review

Acesse chamando const {Review} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
authorAttribution
Tipo:  AuthorAttribution optional
O revisor.
publishTime
Tipo:  Date optional
rating
Tipo:  number optional
A classificação dessa avaliação, um número entre 1,0 e 5,0 (inclusive).
relativePublishTimeDescription
Tipo:  string optional
É uma string de horário recente formatado, expressando o tempo de revisão em relação ao horário atual em um formato adequado para o idioma e o país. Por exemplo, "há um 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 somente a tag de idioma principal, sem nenhuma tag secundária indicando o país ou a região. Por exemplo, todas as avaliações em inglês são marcadas como 'en' em vez de "en-AU" ou "en-UK".

Constantes PriceLevel

Constantes google.maps.places.PriceLevel

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

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

SearchByTextRequest.

Interface google.maps.places.SearchByTextRequest

Interface de solicitação para BetaPlace.searchByText.
fields
Tipo:  Array<string>
Campos a serem incluídos na resposta, que serão faturados. Se ['ALL'] for transmitido, todos os campos disponíveis serão retornados e faturados. Isso não é recomendado para implantações de produção. Para ver uma lista de campos, consulte PlaceResult. Os campos aninhados podem ser especificados com caminhos de ponto (por exemplo, "geometry.location").
includedType optional
Tipo:  string optional
O tipo de lugar solicitado. Lista completa dos tipos compatíveis: https://developers.google.com/maps/documentation/places/web-service/place-types. Somente um tipo incluído é compatível. Consulte SearchByTextRequest.useStrictTypeFiltering
isOpenNow optional
Tipo:  boolean optional
Padrão:false
Usado para restringir a pesquisa a lugares que estão abertos no momento.
language optional
Tipo:  string optional
Os detalhes do lugar serão exibidos com o idioma preferido, se disponível. O padrão será a preferência de idioma do navegador. Lista atual de idiomas compatíveis: https://developers.google.com/maps/faq#languagesupport.
locationBias optional
A região a ser pesquisada. Esse local serve como um viés, o que significa que os resultados relacionados a uma determinada localização podem ser retornados. Não pode ser definido com locationRestriction.
locationRestriction optional
A região a ser pesquisada. Esse local serve como uma restrição, o que significa que resultados fora do local fornecido não serão retornados. Não pode ser definido com locationBias.
maxResultCount optional
Tipo:  number optional
Número máximo de resultados a serem retornados. Esse valor precisa estar entre 1 e 20, inclusive.
minRating optional
Tipo:  number optional
Filtre resultados cuja avaliação média de usuários seja estritamente menor que esse limite. Um valor válido precisa ser uma flutuação entre 0 e 5 (inclusive) em uma cadência de 0,5, ou seja, [0, 0,5, 1,0, ... , 5,0]. A classificação de entrada será arredondada para o 0,5(teto) mais próximo. Por exemplo, uma classificação de 0,6 eliminará todos os resultados com uma classificação inferior a 1,0.
priceLevels optional
Tipo:  Array<PriceLevel> optional
Usado para restringir a pesquisa a lugares marcados como determinados níveis de preço. Todas as combinações de níveis de preço podem ser escolhidas. O padrão é todos os níveis de preço.
query optional
Tipo:  string optional
rankBy optional
Tipo:  SearchByTextRankBy optional
Padrão:SearchByTextRankBy.DISTANCE
Como os resultados serão classificados na resposta.
region optional
Tipo:  string optional
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.
textQuery optional
Tipo:  string optional
Obrigatório. A consulta de texto para pesquisa textual.
useStrictTypeFiltering optional
Tipo:  boolean optional
Padrão:false
Usado para definir a filtragem de tipo restrito para SearchByTextRequest.includedType. Se definido como verdadeiro, apenas resultados do mesmo tipo serão retornados.

Constantes SearchByTextRankBy

Constantes google.maps.places.SearchByTextRankBy

enum RankBy para SearchByTextRequest.

Acesse chamando const {SearchByTextRankBy} = await google.maps.importLibrary("places"). Consulte Bibliotecas na API Maps JavaScript.
DISTANCE Classifica os resultados por distância.
RELEVANCE Classifica os resultados por relevância.