Classe PlacesService
Classe
google.maps.places.PlacesService
Contém métodos relacionados à pesquisa de locais e à recuperação de detalhes sobre um local.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Ao usar v=beta
, é possível chamar const {PlacesService} = await google.map.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Construtor | |
---|---|
PlacesService |
PlacesService(attrContainer) Parâmetros:
Cria uma nova instância do PlacesService que renderiza atribuições no contêiner especificado. |
Métodos | |
---|---|
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 PlaceResult s transmitidos ao callback são subconjuntos de um PlaceResult completo. Seu app pode receber uma PlaceResult mais detalhada para cada lugar chamando PlacesService.getDetails e transmitindo PlaceResult.place_id para o local desejado. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parâmetros:
Valor de retorno: nenhum
Recupera uma lista de locais 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 PlaceResult s transmitidos ao callback são subconjuntos de um PlaceResult completo. Seu app pode receber uma PlaceResult mais detalhada para cada lugar chamando PlacesService.getDetails e transmitindo PlaceResult.place_id para o local desejado. |
getDetails |
getDetails(request, callback) Parâmetros:
Valor de retorno: nenhum
Recupera detalhes sobre o local identificado pelo placeId especificado. |
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 os parâmetros location e radius . As PlaceResult s transmitidas ao callback são subconjuntos da PlaceResult completa. Seu app pode receber uma PlaceResult mais detalhada para cada lugar enviando uma solicitação do Place Details (link em inglês) transmitindo o PlaceResult.place_id para o local desejado. O objeto PlaceSearchPagination pode ser usado para buscar páginas adicionais de resultados (nulo 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 sapatos perto de Ottawa"). Os parâmetros de local são opcionais. Quando o local é especificado, os resultados são direcionados apenas para resultados próximos e não restritos a locais dentro da área. Use textSearch quando quiser pesquisar locais usando uma string arbitrária e nos casos em que você não queira restringir os resultados da pesquisa a um local específico. O objeto PlaceSearchPagination pode ser usado para buscar páginas adicionais de resultados (nulo 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
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
placeId |
Tipo:
string O ID do local para que os detalhes estão sendo solicitados. |
fields optional |
Tipo:
Array<string> optional Campos a serem incluídos na resposta detalhada, que serão faturados. Se nenhum campo for especificado ou ['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" ). |
language 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. |
region 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"). |
sessionToken optional |
Tipo:
AutocompleteSessionToken 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 lugar da solicitação de pesquisa de texto para enviar ao PlacesService.findPlaceFromPhoneNumber
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
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" ). |
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 qual nomes e endereços devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
locationBias optional |
Tipo:
LocationBias optional O viés usado ao pesquisar o local. O resultado é direcionado, mas não restrito, ao LocationBias especificado. |
Interface FindPlaceFromQueryRequest
Interface google.maps.places.FindPlaceFromQueryRequest
Um lugar da solicitação de pesquisa de texto para enviar ao PlacesService.findPlaceFromQuery
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
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" ). |
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 qual nomes e endereços devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
locationBias optional |
Tipo:
LocationBias optional O viés usado ao pesquisar o local. O resultado é direcionado, mas não restrito, ao LocationBias especificado. |
Interface PlaceSearchRequest
Interface google.maps.places.PlaceSearchRequest
Uma consulta de pesquisa de lugar a ser enviada ao PlacesService
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Os limites para pesquisar locais. Tanto location quanto radius serão ignorados se bounds for definido. |
keyword optional |
Tipo:
string optional Um termo que deve corresponder a todos os campos disponíveis, incluindo, entre outros, 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 qual nomes e endereços devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
location optional |
Tipo:
LatLng|LatLngLiteral optional O local em torno do qual pesquisar lugares. |
maxPriceLevel optional |
Tipo:
number optional Restringe os resultados a apenas os locais 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. Precisa ser maior ou igual a minPrice , se especificado. |
minPriceLevel optional |
Tipo:
number optional Restringe os resultados apenas a esses locais 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. |
|
Tipo:
string optional É equivalente a keyword . Os valores neste 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 a partir do local determinado dentro do qual pesquisar lugares, em metros. O valor máximo permitido é 50 000. |
rankBy optional |
Tipo:
RankBy optional Padrão:
RankBy.PROMINENCE 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 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 for fornecida, ela será concatenada para a string de tipo localizada. Os resultados de um tipo diferente são descartados da resposta. Use esse campo para realizar pesquisas categóricas independentes de região e idioma. Os tipos válidos estão disponíveis aqui. |
Interface TextSearchRequest
Interface google.maps.places.TextSearchRequest
Uma solicitação de pesquisa de texto a ser enviada ao PlacesService
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Limites usados para polarizar os resultados ao pesquisar locais (opcional). Tanto location quanto radius serão ignorados se bounds for definido. Os resultados não serão restritos às pessoas dentro desses limites, mas os resultados dentro dela terão uma classificação mais alta. |
language optional |
Tipo:
string optional Um identificador de idioma para o qual nomes e endereços devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
location optional |
Tipo:
LatLng|LatLngLiteral optional O centro da área usada para influenciar resultados ao pesquisar locais. |
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 Nova York") ou o nome de um lugar seguido por um desambiguador de locais ("Starbucks em Sydney"). |
radius optional |
Tipo:
number optional O raio da área usada para influenciar resultados ao pesquisar locais, em metros. |
region optional |
Tipo:
string optional Um código de região para direcionar os resultados. 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"). |
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 for fornecida, ela será concatenada para a string de tipo localizada. Os resultados de um tipo diferente são descartados da resposta. Use esse campo para realizar pesquisas categóricas independentes de região e idioma. Os tipos válidos estão disponíveis aqui. |
RankBy.
google.maps.places.RankBy
constantes
Opções de classificação para uma PlaceSearchRequest.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Ao usar v=beta
, é possível chamar const {RankBy} = await google.map.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
DISTANCE |
As classificações colocam os resultados por distância do local. |
PROMINENCE |
As classificações colocam os resultados em destaque. |
LocationBias (em inglês) defesa
google.maps.places.LocationBias
defesa
Um LocationBias representa um limite flexível ou dica para usar ao pesquisar locais. Os resultados podem vir de fora da área especificada. Para usar o endereço IP do usuário atual como um viés, a string "IP_BIAS"
pode ser especificada. Observação: se você usar um Circle
, o centro e o raio vão precisar ser definidos.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction (em inglês) typedef
google.maps.places.LocationRestriction
defesa
Um LocationRestriction representa um limite restrito a ser usado ao pesquisar locais.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
PlacesServiceStatus.
google.maps.places.PlacesServiceStatus
constantes
O status retornado pelo PlacesService
na conclusão das pesquisas. Especifique-as por valor ou usando o nome da constante. Por exemplo, 'OK'
ou google.maps.places.PlacesServiceStatus.OK
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Ao usar v=beta
, é possível chamar const {PlacesServiceStatus} = await google.map.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
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 excedeu a cota de solicitações. |
REQUEST_DENIED |
O aplicativo não tem permissão para usar a 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á dar certo. |
ZERO_RESULTS |
nenhum resultado foi encontrado para a solicitação. |
Interface PlaceSearchPagination
Interface google.maps.places.PlaceSearchPagination
Um objeto usado para buscar páginas adicionais de resultados do Google Places.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
hasNextPage |
Tipo:
boolean Indica se mais resultados estão disponíveis. true quando há uma página de resultados adicionais. |
Métodos | |
---|---|
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.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
address_components optional |
Tipo:
Array<GeocoderAddressComponent> optional A coleção de componentes de endereço desse local. Disponível apenas no PlacesService.getDetails . |
adr_address optional |
Tipo:
string optional A representação do endereço do lugar no microformato adr. Disponível apenas no PlacesService.getDetails . |
aspects optional |
Tipo:
Array<PlaceAspectRating> optional Os aspectos classificados desse lugar, com base nas avaliações dos usuários do Google e do 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á funcionando ou fechado de forma temporária ou permanente). Se não houver dados disponíveis, a sinalização não estará presente nas respostas de pesquisa ou 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 local, formatado de acordo com a convenção regional do número. Disponível apenas no PlacesService.getDetails . |
geometry optional |
Tipo:
PlaceGeometry optional As informações relacionadas à geometria do lugar. |
html_attributions optional |
Tipo:
Array<string> optional Texto de atribuição a ser exibido para esse resultado de lugar. Os html_attributions disponíveis são sempre retornados, independentemente do que fields foi solicitado e precisam ser exibidos. |
icon optional |
Tipo:
string optional URL de 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 o ícone de um lugar. 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 no PlacesService.getDetails . |
name optional |
Tipo:
string optional O nome do local. Observação: no caso de o usuário inserir lugares, este é o texto bruto, conforme digitado pelo usuário. Tenha cuidado ao usar esses dados, porque usuários mal-intencionados podem tentar usá-lo 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. |
|
Tipo:
boolean optional Uma sinalização que indica se o local está fechado de forma permanente ou temporária. Se o lugar estiver funcionando 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é dez objetos PlacePhoto . |
place_id optional |
Tipo:
string optional Um identificador exclusivo para o local. |
plus_code optional |
Tipo:
PlacePlusCode optional Define códigos de local aberto ou "códigos extras" 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 como:
|
rating optional |
Tipo:
number optional Uma classificação, entre 1,0 e 5,0, com base em avaliações do usuário do lugar. |
reviews optional |
Tipo:
Array<PlaceReview> optional Uma lista de avaliações desse lugar. Disponível apenas no PlacesService.getDetails . |
types optional |
Tipo:
Array<string> optional Uma matriz de tipos para esse 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 de propriedade do Google que contém as melhores informações disponíveis sobre o lugar. Disponível apenas no PlacesService.getDetails . |
user_ratings_total optional |
Tipo:
number optional O número de avaliações dos usuários que contribuíram para os PlaceResult.rating deste lugar. |
|
Tipo:
number optional O deslocamento em relação ao UTC do fuso horário atual do lugar, em minutos. Por exemplo, Sydney, Austrália, no horário de verão está 11 horas à frente do UTC. Portanto, o utc_offset será 660 . Para fusos horários posteriores ao UTC, o deslocamento é negativo. Por exemplo, utc_offset é -60 para Cabo Verde. Disponível apenas no PlacesService.getDetails . |
utc_offset_minutes optional |
Tipo:
number optional O deslocamento em relação ao UTC do fuso horário atual do lugar, em minutos. Por exemplo, Sydney, Austrália, no horário de verão está 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. Disponível apenas no PlacesService.getDetails . |
vicinity optional |
Tipo:
string optional O endereço simplificado do lugar, incluindo nome, número e localidade da rua, mas não a província/estado, o CEP ou o país. Por exemplo, para o escritório do Google em Sydney, Austrália, o valor de proximidade é de "48 Pirrama Road, Pyrmont" . Disponível apenas no PlacesService.getDetails . |
website optional |
Tipo:
string optional O site oficial do lugar, como a página inicial de uma empresa. Disponível apenas no PlacesService.getDetails . |
Interface PlaceAspectRating
Interface google.maps.places.PlaceAspectRating
Define informações sobre um aspecto do lugar que os usuários avaliaram.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
rating |
Tipo:
number É a classificação desse aspecto. Para avaliações individuais, é 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" . |
BusinessStatus
google.maps.places.BusinessStatus
constantes
O status operacional do local, se for uma empresa, retornado em um PlaceResult (indica se o lugar está funcionando ou fechado de forma temporária ou permanente). Especifique-as por valor ou nome da constante (exemplo: 'OPERATIONAL'
ou google.maps.places.BusinessStatus.OPERATIONAL
).
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Ao usar v=beta
, é possível chamar const {BusinessStatus} = await google.map.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
CLOSED_PERMANENTLY |
A empresa está permanentemente fechada. |
CLOSED_TEMPORARILY |
A empresa está fechada temporariamente. |
OPERATIONAL |
A empresa está funcionando normalmente. |
interface PlaceGeometria
Interface google.maps.places.PlaceGeometry
Define informações sobre a geometria de um lugar.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
location optional |
Tipo:
LatLng optional A posição do lugar. |
viewport optional |
Tipo:
LatLngBounds optional Janela de visualização preferencial para exibir esse lugar no mapa. Essa propriedade será null se a janela de visualização preferida do lugar for desconhecida. Disponível apenas no PlacesService.getDetails . |
Interface PlaceOpeningHours
Interface google.maps.places.PlaceOpeningHours
Define informações sobre o horário de funcionamento de um lugar.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
|
Tipo:
boolean optional Se o local está aberto no momento. |
periods optional |
Tipo:
Array<PlaceOpeningHoursPeriod> optional Períodos de cobertura em cada dia da semana, a partir de domingo, em ordem cronológica. Os dias em que o lugar não estiver aberto não serão incluídos. Disponível apenas no PlacesService.getDetails . |
weekday_text optional |
Tipo:
Array<string> optional 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 iniciam a semana na segunda-feira e outros iniciam no domingo. Disponível apenas no PlacesService.getDetails . Outras chamadas podem retornar uma matriz vazia. |
Métodos | |
---|---|
isOpen |
isOpen([date]) Parâmetros:
Valor de retorno:
boolean|undefined Verifique se o lugar está aberto agora (quando nenhuma data tiver passado) 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 por PlacesService.getDetails ). Esse método não considera horários de funcionamento excepcionais, como 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 será exibida na resposta. Os clientes podem confiar que o status "sempre aberto" será representado como um período open
contendo day
com o valor 0
e time
com o valor "0000"
, e nenhum close
.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
open |
O horário de abertura do lugar. |
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.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
day |
Tipo:
number Os dias da semana, como um número no intervalo [ 0 , 6 ], começando no 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á informado no 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 desse PlaceOpeningHoursTime. Ele é calculado com base no PlaceOpeningHoursTime.day da semana, PlaceOpeningHoursTime.time e PlaceResult.utc_offset_minutes . Se PlaceResult.utc_offset_minutes for undefined , nextDate será undefined . |
Interface PlacePlusCode
Interface google.maps.places.PlacePlusCode
Define códigos de local aberto ou "plus code" para um lugar. Os Plus Codes podem ser usados para substituir endereços em lugares onde eles não existem (quando os edifícios não são numerados ou não têm nomes).
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
global_code |
Tipo:
string Um código Plus com 1/8.000o de um grau por 1/8000o de uma área de grau. Por exemplo, "8FVC9G8F+5W" . |
compound_code optional |
Tipo:
string optional Um código plus com 1/8.000o de um grau por 1/8000o de uma á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 houver uma região administrativa 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.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
height |
Tipo:
number É 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. |
Métodos | |
---|---|
getUrl |
getUrl([opts]) Parâmetros:
Valor de retorno:
string Retorna o URL de imagem correspondente às opções especificadas. |
Interface PhotoOptions
Interface google.maps.places.PhotoOptions
Define opções de solicitação de foto.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
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.
Carregar usando o parâmetro de URL &libraries=places
. Consulte Bibliotecas na API Maps JavaScript.
Propriedades | |
---|---|
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 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". |
profile_photo_url |
Tipo:
string Um URL para a imagem de perfil do espectador. |
relative_time_description |
Tipo:
string É 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: "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 o início da era Unix. |
|
Tipo:
Array<PlaceAspectRating> optional Os aspectos avaliados 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. Ele será undefined quando o perfil do revisor não estiver disponível. |
rating optional |
Tipo:
number optional É a nota dessa avaliação, um número entre 1 e 5, inclusive. |