Classe PlacesService
Classe
google.maps.places.PlacesService
Contém métodos relacionados à pesquisa de lugares e à recuperação de detalhes sobre um local.
Acesse chamando const {PlacesService} = await google.maps.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, deve 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 para o callback são subconjuntos de um PlaceResult completo. O app pode receber uma PlaceResult mais detalhada para cada lugar chamando PlacesService.getDetails e transmitindo o PlaceResult.place_id para o lugar desejado. |
findPlaceFromQuery |
findPlaceFromQuery(request, callback) Parâmetros:
Valor de retorno: nenhum
Recupera uma lista de lugares com base em uma string de consulta. Na maioria dos casos, há 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 para o callback são subconjuntos de um PlaceResult completo. Seu app pode receber um PlaceResult mais detalhado para cada local 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 lugar identificado pelo placeId fornecido. |
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 location e radius . Os PlaceResult s transmitidos para o callback são subconjuntos do PlaceResult completo. Seu app pode receber uma PlaceResult mais detalhada para cada lugar enviando uma solicitação de Place Details com o PlaceResult.place_id do local desejado. O objeto PlaceSearchPagination pode ser usado para buscar outras páginas de resultados (nulo se esta 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 locais com base em uma string de consulta (por exemplo, "pizza em São Paulo" ou "loja de sapatos perto do Rio de Janeiro"). Os parâmetros de local são opcionais. Quando o local é especificado, os resultados são direcionados a resultados próximos, em vez de restritos a lugares dentro da área. Use textSearch quando quiser pesquisar lugares usando uma string arbitrária e nos casos em que não quiser restringir os resultados da pesquisa a um local específico. O objeto PlaceSearchPagination pode ser usado para buscar outras páginas de resultados (nulo se esta for a última página de resultados ou se houver apenas uma página de resultados). |
PlaceDetailsRequest
Interface google.maps.places.PlaceDetailsRequest
Uma consulta de detalhes do lugar a ser enviada para o PlacesService
.
Propriedades | |
---|---|
placeId |
Tipo:
string O ID do lugar para o qual os detalhes estão sendo solicitados. |
fields optional |
Tipo:
Array<string> optional Campos a serem incluídos na resposta de detalhes, que serão cobrados. Se nenhum campo for especificado ou ['ALL'] for transmitido, todos os campos disponíveis serão retornados e cobrados. Isso não é recomendado para implantações de produção. Para 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 Identificador do idioma em que os detalhes devem ser retornados. Consulte a lista de idiomas compatíveis. |
region optional |
Tipo:
string optional Um código da região do usuário. Isso pode afetar quais fotos podem ser retornadas 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 do "Reino Unido da Grã-Bretanha e da 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 local da solicitação de pesquisa de texto a ser enviado para PlacesService.findPlaceFromPhoneNumber
.
Propriedades | |
---|---|
fields |
Tipo:
Array<string> Campos a serem incluídos na resposta, que serão cobrados. 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 conferir 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 idioma em que os nomes e endereços devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
locationBias optional |
Tipo:
LocationBias optional A inclinação usada ao pesquisar um lugar. O resultado será direcionado, mas não restrito, ao LocationBias fornecido. |
Interface FindPlaceFromQueryRequest
Interface
google.maps.places.FindPlaceFromQueryRequest
Um local da solicitação de pesquisa de texto a ser enviado para PlacesService.findPlaceFromQuery
.
Propriedades | |
---|---|
fields |
Tipo:
Array<string> Campos a serem incluídos na resposta, que serão cobrados. 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 conferir 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 idioma em que os nomes e endereços devem ser retornados, quando possível. Consulte a lista de idiomas compatíveis. |
locationBias optional |
Tipo:
LocationBias optional A inclinação usada ao pesquisar um lugar. O resultado será direcionado, mas não restrito, ao LocationBias especificado. |
PlaceSearchRequest interface
Interface google.maps.places.PlaceSearchRequest
Uma consulta de pesquisa de lugar a ser enviada para o PlacesService
.
Propriedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Os limites em que pesquisar lugares. Tanto location quanto radius serão ignorados se bounds for definido. |
keyword optional |
Tipo:
string optional Termo a ser correspondido com todos os campos disponíveis, incluindo, entre outros, nome, tipo e endereço, bem como avaliações de clientes e conteúdo de terceiros. |
language optional |
Tipo:
string optional Um identificador de idioma para o idioma em que 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 apenas aos lugares no nível de preço especificado ou em um valor mais baixo. 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 lugares 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 nesse 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 do local especificado 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 é possível especificar um radius ou bounds . |
type optional |
Tipo:
string optional Procura lugares 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 à string de tipo localizada. Resultados de um tipo diferente são excluídos da resposta. Use esse campo para realizar pesquisas categóricas independentes de idioma e região. Os tipos válidos estão aqui. |
Interface TextSearchRequest
Interface
google.maps.places.TextSearchRequest
Uma solicitação de pesquisa de texto a ser enviada para PlacesService
.
Propriedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Limites usados para enviesar os resultados ao pesquisar lugares (opcional). Tanto location quanto radius serão ignorados se bounds for definido. Os resultados não serão restritos àqueles dentro desses limites, mas os resultados dentro dele terão uma classificação mais alta. |
language optional |
Tipo:
string optional Um identificador de idioma para o idioma em que os 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 enviesar os resultados ao pesquisar lugares. |
query optional |
Tipo:
string optional O termo da consulta da solicitação. Por exemplo, o nome de um lugar ("Torre Eiffel"), uma categoria seguida pelo nome de um local ("pizza em Nova York") ou o nome de um lugar seguido por um desambiguador de local ("Starbucks em Sydney"). |
radius optional |
Tipo:
number optional O raio da área usada para influenciar os resultados ao pesquisar lugares, em metros. |
region optional |
Tipo:
string optional Um código de região para dar preferência aos 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 do "Reino Unido da Grã-Bretanha e da Irlanda do Norte"). |
type optional |
Tipo:
string optional Procura lugares 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 à string de tipo localizada. Os resultados de um tipo diferente são excluídos da resposta. Use este campo para realizar pesquisas categóricas independentes de idioma e região. Os tipos válidos estão aqui. |
Constantes RankBy
Constantes
google.maps.places.RankBy
Opções de classificação para um PlaceSearchRequest.
Acesse chamando const {RankBy} = await google.maps.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
DISTANCE |
Classifica os resultados de lugares por distância do local. |
PROMINENCE |
Classifica os resultados de lugares pela proeminência. |
LocationBias typedef
google.maps.places.LocationBias
typedef
Um LocationBias representa um limite flexível ou uma dica a ser usada ao pesquisar lugares. 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 precisam ser definidos.
LatLng|LatLngLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
Tipo definido pelo usuário LocationRestriction
google.maps.places.LocationRestriction
typedef
Uma LocationRestriction representa um limite restrito a ser usado ao pesquisar locais.
Constantes PlacesServiceStatus
Constantes
google.maps.places.PlacesServiceStatus
O status retornado pela PlacesService
na conclusão das pesquisas. Especifique esses valores pelo valor ou usando o nome da constante. Por exemplo, 'OK'
ou google.maps.places.PlacesServiceStatus.OK
.
Acesse chamando const {PlacesServiceStatus} = await google.maps.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
INVALID_REQUEST |
Esta solicitação era 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 sua cota de solicitações. |
REQUEST_DENIED |
O app não tem permissão para usar o PlacesService . |
UNKNOWN_ERROR |
Não foi possível processar a solicitação PlacesService devido a um erro do 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 outras páginas de resultados do Google Places.
Propriedades | |
---|---|
hasNextPage |
Tipo:
boolean Indica se outros resultados estão disponíveis. true é usado quando há uma página de resultados adicionais. |
Métodos | |
---|---|
nextPage |
nextPage() Parâmetros: nenhum
Valor de retorno:
void Busca a próxima página de resultados. Usa a mesma função de callback fornecida para a primeira solicitação de pesquisa. |
PlaceResult
Interface google.maps.places.PlaceResult
Define informações sobre um lugar.
Propriedades | |
---|---|
address_components optional |
Tipo:
Array<GeocoderAddressComponent> optional A coleção de componentes de endereço para a localização desse lugar. Disponível apenas com PlacesService.getDetails . |
adr_address optional |
Tipo:
string optional A representação do endereço do local no microformato adr. Disponível apenas com PlacesService.getDetails . |
aspects optional |
Tipo:
Array<PlaceAspectRating> optional Os aspectos avaliados desse lugar, com base nas avaliações dos usuários do Google e da Zagat. As classificações são em uma escala de 0 a 30. |
business_status optional |
Tipo:
BusinessStatus optional Uma sinalização que indica o status de funcionamento do local, se ele for uma empresa (indica se o lugar está em funcionamento ou se está fechado de forma temporária ou permanente). Se não houver dados disponíveis, a flag não vai aparecer nas respostas de pesquisa ou de detalhes. |
formatted_address optional |
Tipo:
string optional O endereço completo do local. |
formatted_phone_number optional |
Tipo:
string optional O número de telefone do lugar, formatado de acordo com a convenção regional do número. Disponível apenas com PlacesService.getDetails . |
geometry optional |
Tipo:
PlaceGeometry optional 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 de quais fields foram solicitados e precisam ser mostrados. |
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 plano de fundo para uso 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 local 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 lugar. Observação: no caso de lugares inseridos pelo usuário, esse é o texto bruto, conforme digitado pelo usuário. Tenha cuidado ao usar esses dados, porque usuários mal-intencionados podem tentar usá-los como um 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 lugar está fechado, seja permanentemente ou temporariamente. Se o local estiver operacional ou se não houver dados disponíveis, o sinalizador estará ausente da resposta. |
photos optional |
Tipo:
Array<PlacePhoto> optional Fotos deste lugar. A coleção vai conter até dez objetos PlacePhoto . |
place_id optional |
Tipo:
string optional Um identificador exclusivo do lugar. |
plus_code optional |
Tipo:
PlacePlusCode optional Define os códigos de local abertos ou "Plus Codes" do lugar. |
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 da seguinte forma:
|
rating optional |
Tipo:
number optional Uma classificação, entre 1,0 e 5,0, com base em avaliações de usuários para este lugar. |
reviews optional |
Tipo:
Array<PlaceReview> optional Uma lista de avaliações desse lugar. Disponível apenas com PlacesService.getDetails . |
types optional |
Tipo:
Array<string> optional Uma matriz de tipos de 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 do Google que contém as melhores informações disponíveis sobre o local. Disponível apenas com PlacesService.getDetails . |
user_ratings_total optional |
Tipo:
number optional O número de classificações dos usuários que contribuíram para a PlaceResult.rating do local. |
|
Tipo:
number optional A diferença do UTC do fuso horário atual do lugar, em minutos. Por exemplo, em Sydney, na Austrália, o horário de verão está 11 horas à frente do UTC, então o utc_offset será 660 . Para fusos horários atrás do UTC, a diferença é negativa. Por exemplo, utc_offset é -60 para Cabo Verde. Disponível apenas com PlacesService.getDetails . |
utc_offset_minutes optional |
Tipo:
number optional A diferença de fuso horário do local em relação ao UTC, em minutos. Por exemplo, em Sydney, na Austrália, o horário de verão está 11 horas à frente do UTC, então o utc_offset_minutes será 660 . Para fusos horários atrás do UTC, o deslocamento é negativo. Por exemplo, utc_offset_minutes é -60 para Cabo Verde. Disponível apenas com PlacesService.getDetails . |
vicinity optional |
Tipo:
string optional O endereço simplificado do lugar, incluindo o nome da rua, o número e a localidade, mas não a província/estado, o código postal ou o país. Por exemplo, o escritório do Google em Sydney, Austrália, tem um valor de "48 Pirrama Road, Pyrmont" . Disponível apenas com PlacesService.getDetails . |
website optional |
Tipo:
string optional O site oficial do lugar, como a página inicial de uma empresa. Disponível apenas com PlacesService.getDetails . |
Interface PlaceAspectRating
Interface
google.maps.places.PlaceAspectRating
Define informações sobre um aspecto do lugar que os usuários avaliaram.
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" . |
Constantes BusinessStatus
google.maps.places.BusinessStatus
constantes
O status operacional do lugar, se for uma empresa, retornado em um PlaceResult (indica se o lugar está operacional ou fechado temporariamente ou permanentemente). Especifique esses valores pelo valor ou pelo nome da constante (por exemplo, 'OPERATIONAL'
ou google.maps.places.BusinessStatus.OPERATIONAL
).
Acesse chamando const {BusinessStatus} = await google.maps.importLibrary("places")
. Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
---|---|
CLOSED_PERMANENTLY |
A empresa está permanentemente fechada. |
CLOSED_TEMPORARILY |
A empresa está temporariamente fechada. |
OPERATIONAL |
A empresa está funcionando normalmente. |
Interface PlaceGeometry
Interface
google.maps.places.PlaceGeometry
Define informações sobre a geometria de um lugar.
Propriedades | |
---|---|
location optional |
Tipo:
LatLng optional A posição do lugar. |
viewport optional |
Tipo:
LatLngBounds optional A janela de visualização preferencial ao mostrar este lugar em um mapa. Essa propriedade será null se a viewport preferencial do lugar não for conhecida. Disponível apenas com PlacesService.getDetails . |
Interface PlaceOpeningHours
Interface
google.maps.places.PlaceOpeningHours
Define informações sobre o horário de funcionamento de um lugar.
Propriedades | |
---|---|
|
Tipo:
boolean optional Se o lugar está aberto no momento. |
periods optional |
Tipo:
Array<PlaceOpeningHoursPeriod> optional Períodos de funcionamento cobrindo cada dia da semana, começando no domingo, em ordem cronológica. Os dias em que o lugar não está aberto não são incluídos. Disponível apenas com PlacesService.getDetails . |
weekday_text optional |
Tipo:
Array<string> optional Uma matriz de sete strings que representam os horários de funcionamento formatados para cada dia da semana. O serviço Places formatará e localizará os horários de funcionamento apropriadamente para o idioma atual. A ordem dos elementos nessa matriz depende da linguagem. Alguns idiomas iniciam a semana na segunda-feira e outros iniciam no domingo. Disponível apenas com PlacesService.getDetails . Outras chamadas podem retornar uma matriz vazia. |
Métodos | |
---|---|
isOpen |
isOpen([date]) Parâmetros:
Valor de retorno:
boolean|undefined Verifique se o local está aberto agora (quando nenhuma data é informada) ou na data especificada. Se o lugar não tiver PlaceResult.utc_offset_minutes ou PlaceOpeningHours.periods , undefined será retornado (PlaceOpeningHours.periods só está disponível por PlacesService.getDetails ). Esse método não considera horários excepcionais, como feriados. |
Interface PlaceOpeningHoursPeriod
Interface
google.maps.places.PlaceOpeningHoursPeriod
Define informações estruturadas sobre o horário de funcionamento de um lugar. Observação:se um lugar estiver sempre aberto, a seção close
não vai aparecer 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 não close
.
Propriedades | |
---|---|
open |
Tipo:
PlaceOpeningHoursTime O horário de abertura do local. |
close optional |
Tipo:
PlaceOpeningHoursTime optional O horário de fechamento do lugar. |
Interface PlaceOpeningHoursTime
Interface
google.maps.places.PlaceOpeningHoursTime
Define quando um lugar abre ou fecha.
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 ]. Elas serão informadas no fuso horário do lugar. |
minutes |
Tipo:
number Os minutos de PlaceOpeningHoursTime.time em formato numérico, no intervalo [0 , 59 ]. Eles serão informados no fuso horário do lugar. |
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 a época, adequado para uso com new Date() ) que representa a próxima ocorrência desse PlaceOpeningHoursTime. Ele é calculado com base no PlaceOpeningHoursTime.day da semana, no PlaceOpeningHoursTime.time e no PlaceResult.utc_offset_minutes . Se PlaceResult.utc_offset_minutes for undefined , então nextDate será undefined . |
Interface PlacePlusCode
Interface
google.maps.places.PlacePlusCode
Define os códigos de local abertos ou "Plus Codes" de um lugar. Os Plus Codes podem ser usados em vez de endereços nos lugares em que não existem, ou seja, quando os imóveis não estão numerados ou as ruas não têm nome.
Propriedades | |
---|---|
global_code |
Tipo:
string Um Plus Code com uma área de 1/8000 de um grau por 1/8000 de um grau. Por exemplo, "8FVC9G8F+5W" . |
compound_code optional |
Tipo:
string optional Um Plus Code com 1/8.000 de grau por 1/8.000 de grau de área 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 for possível encontrar uma localidade adequada para encurtar o código, esse campo será omitido. |
Interface PlacePhoto
Interface
google.maps.places.PlacePhoto
Representa um elemento de foto de um lugar.
Propriedades | |
---|---|
height |
Tipo:
number A altura da foto em pixels. |
html_attributions |
Tipo:
Array<string> Texto de atribuição a ser exibido para essa foto. |
width |
Tipo:
number A largura da foto em pixels. |
Métodos | |
---|---|
getUrl |
getUrl([opts]) Parâmetros:
Valor de retorno:
string Retorna o URL da imagem correspondente às opções especificadas. |
Interface PhotoOptions
Interface google.maps.places.PhotoOptions
Define as opções de solicitação de fotos.
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.
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 indicando país ou região. Por exemplo, todas as avaliações em inglês são marcadas como 'en' , e não como "en-AU" ou "en-UK". |
profile_photo_url |
Tipo:
string Um URL para a imagem do perfil do revisor. |
relative_time_description |
Tipo:
string Uma string de horário recente formatado, que expressa o horário da avaliação em relação ao horário atual de uma forma adequada para o idioma e o 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 revisão. As classificações em uma escala de 0 a 3. |
author_url optional |
Tipo:
string optional Um URL para o perfil do avaliador. Será undefined quando o perfil do avaliador estiver indisponível. |
rating optional |
Tipo:
number optional A classificação desta avaliação, um número entre 1,0 e 5,0. |