Classe PlacesService
classe
google.maps.places.PlacesService
biblioteca "places"
Contém métodos relacionados à pesquisa de lugares e à recuperação de detalhes sobre um lugar.
const {PlacesService} = await google.maps.importLibrary("places");
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 fornecido. |
nearbySearch |
nearbySearch(request, callback)Parâmetros:
Valor de retorno: nenhum
Recupera uma lista de lugares perto de um local específico, com base em uma palavra-chave ou tipo. O local precisa ser sempre especificado, seja transmitindo um parâmetro LatLngBounds ou location e radius. Os PlaceResults 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 do Place Details com 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 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 apenas direcionados para resultados próximos, em vez de serem restritos a lugares dentro da área. Use textSearch quando quiser pesquisar lugares usando uma string arbitrária e quando 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 Place Details a ser enviada para o PlacesService.
Propriedades | |
|---|---|
placeId |
Tipo:
stringO ID de lugar para o qual os detalhes estão sendo solicitados. |
fields
opcional |
Tipo:
Array<string> optionalCampos a serem incluídos na resposta de detalhes, que serão faturados. 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
opcional |
Tipo:
string optionalUm identificador do idioma em que os detalhes serão retornados. Consulte a lista de idiomas compatíveis. |
region
opcional |
Tipo:
string optionalUm código da região do usuário. Isso pode afetar as fotos que são retornadas e, possivelmente, outras coisas. O código de região 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), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte"). |
sessionToken
opcional |
Tipo:
AutocompleteSessionToken optionalReferência exclusiva usada para agrupar a solicitação de detalhes com uma sessão do Autocomplete. |
Interface FindPlaceFromPhoneNumberRequest
interface
google.maps.places.FindPlaceFromPhoneNumberRequest
Uma solicitação de Text Search para encontrar um lugar a ser enviada para PlacesService.findPlaceFromPhoneNumber.
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 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"). |
phoneNumber |
Tipo:
stringO número de telefone do lugar a ser pesquisado. O formato precisa ser E.164. |
language
opcional |
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
opcional |
Tipo:
LocationBias optionalA polarização usada ao pesquisar um lugar. O resultado será direcionado, mas não restrito, ao LocationBias fornecido. |
Interface FindPlaceFromQueryRequest
interface
google.maps.places.FindPlaceFromQueryRequest
Uma solicitação de Text Search para encontrar um lugar a ser enviada para PlacesService.findPlaceFromQuery.
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 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"). |
query |
Tipo:
stringA consulta da solicitação. Por exemplo, o nome ou endereço de um lugar. |
language
opcional |
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
opcional |
Tipo:
LocationBias optionalA polarização usada ao pesquisar um lugar. O resultado será direcionado, mas não restrito, ao LocationBias fornecido. |
Interface PlaceSearchRequest
interface
google.maps.places.PlaceSearchRequest
Uma consulta de pesquisa de lugar a ser enviada para PlacesService.
Propriedades | |
|---|---|
bounds
opcional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optionalOs limites em que os lugares serão pesquisados. location e radius serão ignorados se bounds estiver definido. |
keyword
opcional |
Tipo:
string optionalUm termo que deve ser comparado com todos os campos disponíveis, incluindo, mas não se limitando a nome, tipo e endereço, avaliações de clientes e outro conteúdo de terceiros. |
language
opcional |
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
opcional |
Tipo:
LatLng|LatLngLiteral optionalO local em que os lugares serão pesquisados. |
maxPriceLevel
opcional |
Tipo:
number optionalRestringe 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
opcional |
Tipo:
number optionalRestringe 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. |
opcional |
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
opcional |
Tipo:
boolean optionalRestringe os resultados apenas aos lugares que estão abertos no momento. |
radius
opcional |
Tipo:
number optionalA distância do local fornecido para pesquisar lugares, em metros. O valor máximo permitido é 50.000. |
rankBy
opcional |
Tipo:
RankBy optionalPadrão:
RankBy.PROMINENCEEspecifica o método de classificação a ser usado ao retornar resultados. Quando rankBy for definido como DISTANCE, você vai ter que especificar um location, mas não vai ser possível especificar um radius ou bounds. |
type
opcional |
Tipo:
string optionalPesquisa lugares do tipo indicado. O tipo é traduzido para o idioma local da região de segmentação 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 descartados da resposta. Use esse campo para realizar pesquisas categóricas independentes de idioma e região. Os tipos válidos estão disponíveis aqui. |
Interface TextSearchRequest
interface
google.maps.places.TextSearchRequest
Uma solicitação de Text Search a ser enviada para PlacesService.
Propriedades | |
|---|---|
bounds
opcional |
Tipo:
LatLngBounds|LatLngBoundsLiteral optionalLimites usados para influenciar 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 que estiverem dentro deles terão uma classificação mais alta. |
language
opcional |
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
opcional |
Tipo:
LatLng|LatLngLiteral optionalO centro da área usada para priorizar resultados ao pesquisar lugares. |
query
opcional |
Tipo:
string optionalO termo de consulta da solicitação. Por exemplo, o nome de um lugar ("Torre Eiffel"), uma categoria seguida pelo nome de um local ("pizza em São Paulo") ou o nome de um lugar seguido por um desambiguador de local ("Starbucks em Sydney"). |
radius
opcional |
Tipo:
number optionalO raio da área usada para polarizar os resultados ao pesquisar lugares, em metros. |
region
opcional |
Tipo:
string optionalUm código de região para direcionar os resultados. O código de região 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), enquanto o código ISO 3166-1 é "gb" (tecnicamente para a entidade "Reino Unido da Grã-Bretanha e Irlanda do Norte"). |
type
opcional |
Tipo:
string optionalPesquisa lugares do tipo indicado. O tipo é traduzido para o idioma local da região de segmentação 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 descartados da resposta. Use esse campo para realizar pesquisas categóricas independentes de idioma e região. Os tipos válidos estão disponíveis aqui. |
Constantes RankBy
constantes
google.maps.places.RankBy
biblioteca "places"
Opções de classificação para uma PlaceSearchRequest.
const {RankBy} = await google.maps.importLibrary("places");
Constantes | |
|---|---|
DISTANCE |
Classifica os resultados de lugares por distância do local. |
PROMINENCE |
Classifica os resultados de lugares de acordo com o destaque. |
typedef LocationBias
typedef
google.maps.places.LocationBias
Um LocationBias representa um limite flexível ou uma dica para usar ao pesquisar lugares. Os resultados podem vir de fora da área especificada. Para usar o endereço IP do usuário atual como uma tendência, especifique a string "IP_BIAS". Observação: se você usar um Circle, o centro e o raio precisam ser definidos.
LatLng|LatLngLiteral|LatLngAltitude|LatLngAltitudeLiteral|LatLngBounds|LatLngBoundsLiteral|Circle|CircleLiteral|string
typedef LocationRestriction
typedef
google.maps.places.LocationRestriction
Um LocationRestriction representa um limite estrito a ser usado ao pesquisar lugares.
Constantes PlacesServiceStatus
constantes
google.maps.places.PlacesServiceStatus
biblioteca "places"
O status retornado pelo PlacesService após a conclusão das pesquisas. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'OK' ou google.maps.places.PlacesServiceStatus.OK.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo PlacesServiceStatusString.
const {PlacesServiceStatus} = await google.maps.importLibrary("places");
Constantes | |
|---|---|
INVALID_REQUEST |
Esta solicitação era inválida. |
NOT_FOUND |
O lugar indicado não foi encontrado. |
OK |
A resposta contém um resultado válido. |
OVER_QUERY_LIMIT |
O aplicativo ultrapassou a cota de solicitações. |
REQUEST_DENIED |
O aplicativo não tem permissão para usar o PlacesService. |
UNKNOWN_ERROR |
Não foi possível processar a solicitação do 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 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:
voidBusca 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
opcional |
Tipo:
Array<GeocoderAddressComponent> optionalA coleção de componentes de endereço do local. Disponível apenas com PlacesService.getDetails. |
adr_address
opcional |
Tipo:
string optionalA representação do endereço do lugar no microformato adr. Disponível apenas com PlacesService.getDetails. |
aspects
opcional |
Tipo:
Array<Os aspectos avaliados do lugar, com base nas avaliações de usuários do Google e da Zagat. As classificações estão em uma escala de 0 a 30. |
business_status
opcional |
Tipo:
BusinessStatus optionalUma sinalização que indica o status de funcionamento do lugar, se for uma empresa (se está em funcionamento ou fechado temporária ou permanentemente). Se não houver dados disponíveis, a sinalização não vai aparecer nas respostas de pesquisa ou detalhes. |
formatted_address
opcional |
Tipo:
string optionalO endereço completo do lugar. |
formatted_phone_number
opcional |
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
opcional |
Tipo:
PlaceGeometry optionalInformações relacionadas à geometria do lugar. |
html_attributions
opcional |
Tipo:
Array<string> optionalTexto de atribuição a ser exibido para esse resultado de lugar. As html_attributions disponíveis são sempre retornadas, independentemente de quais fields foram solicitadas, e precisam ser mostradas. |
icon
opcional |
Tipo:
string optionalURL de um recurso de imagem que pode ser usado para representar a categoria desse lugar. |
icon_background_color
opcional |
Tipo:
string optionalCor do plano de fundo para uso com o ícone de um lugar. Consulte também PlaceResult.icon_mask_base_uri. |
icon_mask_base_uri
opcional |
Tipo:
string optionalUm URL truncado para uma máscara de ícone. Acesse diferentes tipos de ícones adicionando uma extensão de arquivo ao final (por exemplo, .svg ou .png). |
international_phone_number
opcional |
Tipo:
string optionalO 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 com PlacesService.getDetails. |
name
opcional |
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 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
opcional |
Tipo:
PlaceOpeningHours optionalDefine quando o lugar abre ou fecha. |
opcional |
Tipo:
boolean optionalUma sinalização 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
opcional |
Tipo:
Array<PlacePhoto> optionalFotos do lugar. A coleção vai conter até dez objetos PlacePhoto. |
place_id
opcional |
Tipo:
string optionalUm identificador exclusivo do lugar. |
plus_code
opcional |
Tipo:
PlacePlusCode optionalDefine códigos de localização abertos ou Plus Codes para o lugar. |
price_level
opcional |
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
opcional |
Tipo:
number optionalUma classificação, entre 1,0 e 5,0, com base nas avaliações de usuários desse lugar. |
reviews
opcional |
Tipo:
Array<PlaceReview> optionalUma lista de avaliações do lugar. Disponível apenas com PlacesService.getDetails. |
types
opcional |
Tipo:
Array<string> optionalUma matriz de tipos para esse lugar (por exemplo, ["political", "locality"] ou ["restaurant", "establishment"]). |
url
opcional |
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
opcional |
Tipo:
number optionalO número de avaliações de usuários que contribuíram para o PlaceResult.rating deste lugar. |
opcional |
Tipo:
number optionalA diferença em relação ao 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 anteriores ao UTC, o deslocamento é negativo. Por exemplo, o utc_offset é -60 para Cabo Verde. Disponível apenas com PlacesService.getDetails. |
utc_offset_minutes
opcional |
Tipo:
number optionalA diferença em relação ao 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 anteriores ao UTC, o deslocamento é negativo. Por exemplo, o utc_offset_minutes é -60 para Cabo Verde. Disponível apenas com PlacesService.getDetails. |
vicinity
opcional |
Tipo:
string optionalO endereço simplificado do lugar, incluindo o nome da rua, o número da rua e a localidade, mas não província/estado, código postal ou 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
opcional |
Tipo:
string optionalO 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, é um número inteiro de 0 a 3. Para as avaliações agregadas de um lugar, é um número inteiro de 0 a 30. |
type |
Tipo:
stringO tipo de aspecto. Por exemplo, "food", "decor", "service" ou "overall". |
Constantes BusinessStatus
constantes
google.maps.places.BusinessStatus
biblioteca "places"
Status comercial do lugar. Consulte a documentação do serviço da Web para mais informações.
Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo BusinessStatusString.
const {BusinessStatus} = await google.maps.importLibrary("places");
Constantes | |
|---|---|
CLOSED_PERMANENTLY |
O estabelecimento está permanentemente fechado. Consulte a documentação do serviço da Web para mais informações. |
CLOSED_TEMPORARILY |
O estabelecimento está temporariamente fechado. Consulte a documentação do serviço da Web para mais informações. |
FUTURE_OPENING |
O estabelecimento vai abrir no futuro. Consulte a documentação do serviço da Web para mais informações. |
OPERATIONAL |
O estabelecimento está em funcionamento, mas não necessariamente aberto no momento. Consulte a documentação do serviço da Web para mais informações. |
Interface PlaceGeometry
interface
google.maps.places.PlaceGeometry
Define informações sobre a geometria de um lugar.
Propriedades | |
|---|---|
location
opcional |
Tipo:
LatLng optionalA posição do lugar. |
viewport
opcional |
Tipo:
LatLngBounds optionalA janela de visualização preferida ao mostrar esse lugar em um mapa. Essa propriedade será null se a janela de visualização preferencial do lugar for desconhecida. 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 | |
|---|---|
opcional |
Tipo:
boolean optionalSe o lugar está aberto no momento. |
periods
opcional |
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
opcional |
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 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 com PlacesService.getDetails. Outras chamadas podem retornar uma matriz vazia. |
Métodos | |
|---|---|
isOpen |
isOpen([date])Parâmetros:
Valor de retorno:
boolean|undefinedVerifica se o lugar 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 em 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 têm o status de "sempre aberto" representado como um período open contendo day com valor 0 e time com valor "0000", sem close.
Propriedades | |
|---|---|
open |
Tipo:
PlaceOpeningHoursTimeO horário de abertura do lugar. |
close
opcional |
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"]. O horário será informado no fuso horário do lugar. |
nextDate
opcional |
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 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 Open Location Codes 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
opcional |
Tipo:
string optionalUm Plus Code com uma área de 1/8.000 de grau por 1/8.000 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 exibido para essa 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 as opções de solicitação de fotos.
Propriedades | |
|---|---|
maxHeight
opcional |
Tipo:
number optionalA altura máxima em pixels da imagem retornada. |
maxWidth
opcional |
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 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 são marcadas como 'en', e não "en-AU" ou "en-UK". |
profile_photo_url |
Tipo:
stringUm URL para a imagem de perfil do avaliador. |
relative_time_description |
Tipo:
stringUma string de horário recente formatado, que expressa o horário da avaliação em relação ao horário atual em um formato apropriado para o idioma e o país. Por exemplo: "a month ago" |
text |
Tipo:
stringO texto de uma avaliação. |
time |
Tipo:
numberO carimbo de data/hora da avaliação, expresso em segundos desde o início da era Unix. |
opcional |
Tipo:
Array<Os aspectos avaliados. As classificações em uma escala de 0 a 3. |
author_url
opcional |
Tipo:
string optionalUm URL para o perfil do avaliador. Será undefined quando o perfil do avaliador estiver indisponível. |
rating
opcional |
Tipo:
number optionalA nota da avaliação, um número entre 1,0 e 5,0 (inclusive). |