Classe PlacesService
Classe
google.maps.places.PlacesService
Contém métodos relacionados à pesquisa de lugares e à recuperação de detalhes sobre um lugar.
Acesse ligando para 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, 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 PlaceResults transmitidos ao callback são subconjuntos de um PlaceResult completo. Seu app pode receber um PlaceResult mais detalhado para cada lugar chamando PlacesService.getDetails e transmitindo o PlaceResult.place_id do 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 PlaceResults transmitidos ao callback são subconjuntos de um PlaceResult completo. Seu app pode receber um PlaceResult mais detalhado para cada lugar chamando PlacesService.getDetails e transmitindo o PlaceResult.place_id do lugar desejado. |
getDetails |
getDetails(request, callback)Parâmetros:
Valor de retorno:nenhum
Recupera detalhes sobre o lugar identificado pelo placeId especificado. |
nearbySearch |
nearbySearch(request, callback)Parâmetros:
Valor de retorno:nenhum
Recupera uma lista de lugares perto de um local específico, com base em palavra-chave ou tipo. O local precisa ser sempre especificado, seja transmitindo um parâmetro LatLngBounds ou location e radius. Os PlaceResults transmitidos ao 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 que transmita o PlaceResult.place_id do lugar desejado. O objeto PlaceSearchPagination pode ser usado para buscar outras páginas de resultados (nulo se esta for a última página 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 "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 para os locais próximos, em vez de serem restritos a lugares dentro da área. Use textSearch quando quiser pesquisar lugares usando uma string arbitrária e em casos em que não é necessário 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 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:
stringO ID do lugar para o qual os detalhes estão sendo solicitados. |
fields optional |
Tipo:
Array<string> optionalCampos 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 serão 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 optionalUm identificador do idioma em que os detalhes devem ser retornados. Consulte a lista de idiomas compatíveis. |
region optional |
Tipo:
string optionalUm 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 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"). |
sessionToken optional |
Tipo:
AutocompleteSessionToken optionalReferê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 pesquisa de lugar por texto a ser enviada 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, 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"). |
phoneNumber |
Tipo:
stringO número de telefone do lugar a ser pesquisado. O formato precisa ser E.164. |
language optional |
Tipo:
string optionalUm identificador do 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 optionalO viés usado ao pesquisar um lugar. O resultado será direcionado, mas não restrito, ao LocationBias especificado. |
Interface FindPlaceFromQueryRequest
Interface google.maps.places.FindPlaceFromQueryRequest
Uma solicitação de pesquisa de lugar por texto a ser enviada 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, 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"). |
query |
Tipo:
stringA consulta da solicitação. Por exemplo, o nome ou endereço de um lugar. |
language optional |
Tipo:
string optionalUm identificador do 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 optionalO viés usado ao pesquisar um lugar. O resultado será direcionado, mas não restrito, ao LocationBias especificado. |
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 optionalOs limites em que pesquisar lugares. location e radius serão ignorados se bounds for definido. |
keyword optional |
Tipo:
string optionalUm termo que deve ser comparado com todos os campos disponíveis, inclusive, entre outros, nome, tipo e endereço, além de avaliações de clientes e outros materiais de terceiros. |
language optional |
Tipo:
string optionalUm identificador do 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 optionalO local em torno do qual pesquisar lugares. |
maxPriceLevel optional |
Tipo:
number optionalRestringe os resultados apenas a 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 optionalRestringe 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 optionalRestringe os resultados apenas a lugares que estão abertos no momento. |
radius optional |
Tipo:
number optionalA distância do local especificado em que pesquisar lugares, em metros. O valor máximo permitido é 50.000. |
rankBy optional |
Tipo:
RankBy optionalPadrão:
RankBy.PROMINENCEEspecifica 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 optionalPesquisa 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 descartados 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 a ser enviada para PlacesService.
Propriedades | |
|---|---|
bounds optional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optionalLimites usados para influenciar os resultados ao pesquisar lugares (opcional). location e radius serão ignorados se bounds for definido. Os resultados não serão restritos a locais dentro desses limites, mas os resultados dentro deles terão uma classificação mais alta. |
language optional |
Tipo:
string optionalUm identificador do 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 optionalO centro da área usada para influenciar os resultados ao pesquisar lugares. |
query optional |
Tipo:
string optionalO 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 de um disambiguador de local ("Starbucks em Sydney"). |
radius optional |
Tipo:
number optionalO raio da área usada para polarizar os resultados ao pesquisar lugares, em metros. |
region optional |
Tipo:
string optionalUm código de região para direcionar os resultados. 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"). |
type optional |
Tipo:
string optionalPesquisa 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 descartados 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 de google.maps.places.RankBy
Opções de classificação para um PlaceSearchRequest.
Acesse ligando para 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 por destaque. |
LocationBias typedef
google.maps.places.LocationBias
typedef
Um LocationBias representa um limite ou uma dica flexível 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 variável de tendência, especifique a string "IP_BIAS". Observação: se você estiver usando um Circle, o centro e o raio precisarão ser definidos.
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
LocationRestriction typedef
google.maps.places.LocationRestriction
typedef
Uma LocationRestriction representa um limite estrito a ser usado ao pesquisar lugares.
Constantes PlacesServiceStatus
Constantes de google.maps.places.PlacesServiceStatus
O status retornado pelo PlacesService ao concluir as pesquisas. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'OK' ou google.maps.places.PlacesServiceStatus.OK.
Acesse ligando para 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 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 outras páginas de resultados do Places.
Propriedades | |
|---|---|
hasNextPage |
Tipo:
booleanIndica se há mais resultados disponíveis. true quando há uma página de resultados adicionais. |
Métodos | |
|---|---|
nextPage |
nextPage()Parâmetros:nenhum
Valor de retorno:
voidBusca a próxima página de resultados. Usa a mesma função de callback fornecida à 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> optionalA coleção de componentes de endereço para o local deste lugar. Disponível apenas com PlacesService.getDetails. |
adr_address optional |
Tipo:
string optionalA representação do endereço do lugar no microformato adr. Disponível apenas com PlacesService.getDetails. |
aspects optional |
Tipo:
Array<PlaceAspectRating> optionalOs aspectos avaliados deste lugar, com base nas avaliações de usuários do Google e da Zagat. As classificações são em uma escala de 0 a 30. |
business_status optional |
Tipo:
BusinessStatus optionalUma flag que indica o status operacional do lugar, se for uma empresa (indica se o lugar está funcionando ou fechado temporária 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 optionalO endereço completo do lugar. |
formatted_phone_number optional |
Tipo:
string optionalO 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 optionalInformações relacionadas à geometria do lugar. |
html_attributions optional |
Tipo:
Array<string> optionalTexto de atribuição a ser exibido para este resultado de lugar. Os html_attributions disponíveis são sempre retornados, independente dos fields solicitados, e precisam ser mostrados. |
icon optional |
Tipo:
string optionalURL de um recurso de imagem que pode ser usado para representar a categoria do lugar. |
icon_background_color optional |
Tipo:
string optionalCor 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 optionalUm URL truncado para uma máscara de ícone. Para acessar diferentes tipos de ícones, adicione uma extensão de arquivo ao final (por exemplo, .svg ou .png). |
international_phone_number optional |
Tipo:
string optionalO número de telefone do lugar em 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 optionalO 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, já que usuários maliciosos 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 optionalDefine quando o lugar abre ou fecha. |
|
Tipo:
boolean optionalUma flag que indica se o lugar está fechado, de forma permanente ou temporária. Se o lugar estiver em funcionamento ou se não houver dados disponíveis, a flag não vai aparecer na resposta. |
photos optional |
Tipo:
Array<PlacePhoto> optionalFotos deste lugar. A coleção vai conter até dez objetos PlacePhoto. |
place_id optional |
Tipo:
string optionalUm identificador exclusivo do lugar. |
plus_code optional |
Tipo:
PlacePlusCode optionalDefine códigos de geolocalização abertos ou Plus Codes para o lugar. |
price_level optional |
Tipo:
number optionalO 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 forma:
|
rating optional |
Tipo:
number optionalUma classificação, entre 1,0 e 5,0, com base nas avaliações dos usuários sobre este lugar. |
reviews optional |
Tipo:
Array<PlaceReview> optionalUma lista de avaliações deste lugar. Disponível apenas com PlacesService.getDetails. |
types optional |
Tipo:
Array<string> optionalUma matriz de tipos para este lugar (por exemplo, ["political", "locality"] ou ["restaurant", "establishment"]). |
url optional |
Tipo:
string optionalURL 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 optionalO número de avaliações de usuários que contribuíram para a PlaceResult.rating deste lugar. |
|
Tipo:
number optionalO deslocamento do UTC do fuso horário atual do lugar, em minutos. Por exemplo, Sydney, na Austrália, no horário de verão, está 11 horas à frente do UTC. Portanto, o utc_offset será 660. Para fusos horários atrás do UTC, o ajuste é negativo. Por exemplo, o utc_offset é -60 para Cabo Verde. Disponível apenas com PlacesService.getDetails. |
utc_offset_minutes optional |
Tipo:
number optionalO deslocamento do UTC do fuso horário atual do lugar, em minutos. Por exemplo, Sydney, na 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 atrás do UTC, o ajuste é negativo. Por exemplo, o utc_offset_minutes é -60 para Cabo Verde. Disponível apenas com PlacesService.getDetails. |
vicinity optional |
Tipo:
string optionalO 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 proximidade de "48 Pirrama Road, Pyrmont". Disponível apenas com PlacesService.getDetails. |
website optional |
Tipo:
string optionalO 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:
numberA classificação deste aspecto. Para avaliações individuais, é 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:
stringO tipo de aspecto. Por exemplo, "food", "decor", "service" ou "overall". |
Constantes BusinessStatus
Constantes de 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 temporária ou permanentemente). Especifique-os por valor ou pelo nome da constante (exemplo: 'OPERATIONAL' ou google.maps.places.BusinessStatus.OPERATIONAL).
Acesse ligando para const {BusinessStatus} = await google.maps.importLibrary("places").
Consulte Bibliotecas na API Maps JavaScript.
Constantes | |
|---|---|
CLOSED_PERMANENTLY |
A empresa está fechada permanentemente. |
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 optionalA posição do lugar. |
viewport optional |
Tipo:
LatLngBounds optionalA janela de visualização preferida ao mostrar este lugar em um mapa. Essa propriedade será null se a janela de visualização preferida 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 optionalSe o lugar está aberto no momento. |
periods optional |
Tipo:
Array<PlaceOpeningHoursPeriod> optionalPeríodos de funcionamento para 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> optionalUma 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 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 com PlacesService.getDetails. Outras chamadas podem retornar uma matriz vazia. |
Métodos | |
|---|---|
isOpen |
isOpen([date])Parâmetros:
Valor de retorno:
boolean|undefinedVerifique se o lugar está aberto agora (quando nenhuma data é transmitida) 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 via PlacesService.getDetails). Esse método não considera horários excepcionais, como horários de 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 |
O horário de abertura do lugar. |
close optional |
Tipo:
PlaceOpeningHoursTime optionalO horário de fechamento do lugar. |
Interface PlaceOpeningHoursTime
Interface google.maps.places.PlaceOpeningHoursTime
Define quando um lugar abre ou fecha.
Propriedades | |
|---|---|
day |
Tipo:
numberOs dias da semana, como um número no intervalo [ 0, 6], começando no domingo. Por exemplo, 2 significa terça-feira. |
hours |
Tipo:
numberAs horas do PlaceOpeningHoursTime.time como um número, no intervalo [0, 23]. Isso será informado no fuso horário do lugar. |
minutes |
Tipo:
numberOs minutos do PlaceOpeningHoursTime.time como um número, no intervalo [0, 59]. Isso será informado no fuso horário do lugar. |
time |
Tipo:
stringA hora do dia no formato "hhmm" de 24 horas. Os valores estão no intervalo [ "0000", "2359"]. A hora será informada no fuso horário do lugar. |
nextDate optional |
Tipo:
number optionalO carimbo de data/hora (em milissegundos desde a época, adequado para uso com new Date()) que representa a próxima ocorrência de PlaceOpeningHoursTime. Ele é calculado com base no PlaceOpeningHoursTime.day da semana, no PlaceOpeningHoursTime.time e no PlaceResult.utc_offset_minutes. Se o PlaceResult.utc_offset_minutes for undefined, nextDate será undefined. |
Interface PlacePlusCode
Interface google.maps.places.PlacePlusCode
Define códigos de local aberto ou Plus Codes para 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:
stringUm 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 optionalUm Plus Code com uma área de 1/8000 de grau por 1/8000 de grau em que os quatro primeiros 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:
numberA altura da foto em pixels. |
html_attributions |
Tipo:
Array<string>Texto de atribuição a ser mostrado para esta foto. |
width |
Tipo:
numberA largura da foto em pixels. |
Métodos | |
|---|---|
getUrl |
getUrl([opts])Parâmetros:
Valor de retorno:
stringRetorna o URL da imagem correspondente às opções especificadas. |
Interface PhotoOptions
Interface google.maps.places.PhotoOptions
Define opções de solicitação de fotos.
Propriedades | |
|---|---|
maxHeight optional |
Tipo:
number optionalA altura máxima em pixels da imagem retornada. |
maxWidth optional |
Tipo:
number optionalA 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:
stringO nome do avaliador. |
language |
Tipo:
stringUm código de idioma IETF que indica o idioma em que esta avaliação foi escrita. Esse código inclui apenas a tag do 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', e não "en-AU" ou "en-UK". |
profile_photo_url |
Tipo:
stringUm URL para a imagem do perfil do avaliador. |
relative_time_description |
Tipo:
stringUma string de tempo recente formatado, expressando o tempo da avaliação em relação ao tempo atual de uma forma adequada ao idioma e ao país. Por exemplo: "a month ago" |
text |
Tipo:
stringO texto de uma avaliação. |
time |
Tipo:
numberCarimbo de data/hora da avaliação, expresso em segundos desde o período. |
|
Tipo:
Array<PlaceAspectRating> optionalOs aspectos avaliados na avaliação. As classificações em uma escala de 0 a 3. |
author_url optional |
Tipo:
string optionalUm URL para o perfil do avaliador. Será undefined quando o perfil do avaliador não estiver disponível. |
rating optional |
Tipo:
number optionalA classificação da avaliação, um número entre 1,0 e 5,0 (inclusive). |