Classe PlacesService
Classe
google.maps.places.PlacesService
Contém métodos relacionados à pesquisa de lugares e à recuperação de detalhes sobre um lugar.
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 ao callback são subconjuntos de um PlaceResult completo. O app pode receber um PlaceResult mais detalhado 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, 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 ao callback são subconjuntos de um PlaceResult completo. O app pode receber um PlaceResult mais detalhado para cada lugar chamando PlacesService.getDetails e transmitindo o PlaceResult.place_id para o lugar 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 um PlaceResult mais detalhado 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 lugares com base em uma string de consulta (por exemplo, "pizza em São Paulo" ou "lojas 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 locais 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). |
Interface 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 se ['ALL'] for transmitido, todos os campos disponíveis vão ser retornados e faturados, o que 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 Um identificador de idioma para o idioma em que os detalhes precisam 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 regional aceita um valor de dois caracteres de 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 ), e 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
Uma solicitação de Find Place from Text Search para ser enviada a 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 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 o lugar. O resultado será tendencioso, mas não restrito, em relação ao LocationBias fornecido. |
Interface FindPlaceFromQueryRequest
Interface
google.maps.places.FindPlaceFromQueryRequest
Uma solicitação de Find Place from Text Search para ser enviada a 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 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 o lugar. O resultado será tendencioso, mas não restrito, em relação ao LocationBias fornecido. |
Interface PlaceSearchRequest
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. location e radius serão ignorados se bounds estiver definido. |
keyword optional |
Tipo:
string optional Um termo que deve ser comparado com todos os campos disponíveis, inclusive, entre outros, nome, tipo e endereço, avaliações de clientes e outros materiais de terceiros. |
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 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 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 aos 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 em que 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 Pesquisa 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 este 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 para ser enviada ao PlacesService
.
Propriedades | |
---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optional Limites usados para enviesar os resultados ao pesquisar lugares (opcional). location e radius serão ignorados se bounds estiver definido. Os resultados não serão restritos aos que estão dentro desses limites, mas os resultados dentro deles vão ter 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 disambiguador de local ("Starbucks em Sydney"). |
radius optional |
Tipo:
number optional O raio da área usada para enviesar os resultados ao pesquisar lugares, em metros. |
region optional |
Tipo:
string optional Um código de região para direcionar os resultados. O código regional aceita um valor de dois caracteres de 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 ), e 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 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 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 pela distância do local. |
PROMINENCE |
Classifica os resultados de lugares pela proeminência. |
Tipo definido pelo usuário LocationBias
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 uma inclinação, 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 rígido a ser usado ao pesquisar lugares.
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 a 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 no 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: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.
Propriedades | |
---|---|
address_components optional |
Tipo:
Array<GeocoderAddressComponent> optional A coleção de componentes de endereço para o local do lugar. Disponível apenas com PlacesService.getDetails . |
adr_address optional |
Tipo:
string optional A representação do endereço do lugar 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 operacional do lugar, se for uma empresa (indica se o lugar está operacional ou fechado temporariamente ou permanentemente). 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 lugar. |
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 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 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 ícone 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 com 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 lugar estiver operacional ou se não houver dados disponíveis, a sinalização não vai aparecer na 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 lugar, em uma escala de 0 a 4. Os níveis de preço são interpretados da seguinte maneira:
|
rating optional |
Tipo:
number optional Uma classificação, entre 1,0 e 5,0, com base nas avaliações dos usuários desse 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 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 estabelecimento no Google com 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 de usuários que contribuíram para a PlaceResult.rating do lugar. |
|
Tipo:
number optional A diferença de fuso horário do UTC do lugar atual, em minutos. Por exemplo, Sydney, na Austrália, está 11 horas à frente do UTC no horário de verão, então o utc_offset será 660 . Para fusos horários atrás do UTC, o deslocamento é negativo. 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 UTC do lugar atual, em minutos. Por exemplo, Sydney, na Austrália, está 11 horas à frente do UTC no horário de verão, 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 da rua 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, na 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 da empresa na Web. 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, esse é um número inteiro de 0 a 3. Para classificações agregadas de um lugar, esse é um número inteiro de 0 a 30. |
type |
Tipo:
string O tipo de aspecto. Por exemplo, "food" , "decor" , "service" ou "overall" . |
Constantes BusinessStatus
Constantes
google.maps.places.BusinessStatus
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 preferida 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 formata e localiza os horários de funcionamento de acordo com 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 contar com o status "sempre aberto" representado como um período open
contendo day
com valor 0
e time
com valor "0000"
, sem close
.
Propriedades | |
---|---|
open |
Horário de abertura do lugar. |
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 do PlaceOpeningHoursTime.time como um número, no intervalo [0 , 23 ]. Isso será informado no fuso horário do lugar. |
minutes |
Tipo:
number Os minutos da PlaceOpeningHoursTime.time como um número, no intervalo [0 , 59 ]. Isso será informado 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 , 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 uma área de 1/8000 de grau por 1/8000 de grau, em que os quatro primeiros caracteres (o código da área) são removidos e substituídos por uma descrição da 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 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 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 na 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 revisor estiver indisponível. |
rating optional |
Tipo:
number optional A classificação desta avaliação, um número entre 1,0 e 5,0. |