As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Pesquisar nas proximidades
A API Pesquisar nas proximidades permite que os desenvolvedores consultem pontos de interesse dentro de um raio especificado tendo como base coordenadas centrais. A API fornece resultados locais com filtros opcionais, incluindo categorias, cadeias de negócios, tipos de alimentos e muito mais. Os detalhes da resposta incluem nome do local, endereço, telefone, categoria, tipo de comida, contato e horário de funcionamento. Atributos adicionais, como fonemas, fusos horários e outros, estão disponíveis com base nos parâmetros solicitados.
nota
Se os resultados forem armazenados, eles serão cobrados no nível mais alto de preço de armazenamento. Use o parâmetro IntendedUse para especificar se os resultados são para uso único ou armazenamento. Consulte Preços de locais para obter detalhes sobre os custos associados aos resultados armazenados.
Para obter mais informações, consulte SearchNearby na Referência de API do Amazon Location Service.
Para obter exemplos de solicitações, respostas, comandos cURL e CLI para essa API, consulte Como usar Pesquisar nas proximidades.
Casos de uso
-
Aplicações imobiliárias: forneça aos potenciais compradores ou locatários uma lista de comodidades e serviços próximos a uma propriedade, como escolas, hospitais e shopping centers.
-
Descoberta de negócios locais: permita que os usuários localizem empresas, restaurantes ou lojas em um raio específico de sua localização atual. Por exemplo, um aplicativo de entrega de comida pode exibir restaurantes próximos com base na localização em tempo real.
-
Aplicativos de viagens e turismo: ajude os viajantes a explorar atrações, pontos turísticos, hotéis e serviços próximos à sua localização ou destino. Um aplicativo de viagem pode sugerir pontos de interesse próximos, como museus, parques e locais históricos.
-
Serviços de emergência: ajude os usuários a encontrar os hospitais, delegacias de polícia ou farmácias mais próximos durante emergências, especialmente valiosos para aplicativos focados em saúde, segurança ou resposta a desastres.
-
Transporte e logística: ajude os usuários a encontrar os postos de gasolina, pontos de carregamento de veículos elétricos ou pontos de transporte público mais próximos. Os serviços de carona podem exibir os motoristas disponíveis nas proximidades.
Sobre a solicitação
A solicitação da API Pesquisar as proximidades inclui parâmetros obrigatórios, como QueryPosition e parâmetros opcionais, como filtros, para refinar a pesquisa. Opções adicionais, como Language e PoliticalView, personalizam resultados para necessidades específicas. Para obter mais informações, consulte a Referência da API de Pesquisar nas proximidades.
A solicitação inclui os seguintes parâmetros principais:
- Autenticação
-
O parâmetro
Keyé opcional quando outros métodos de autenticação são usados.-
Key: chave de API para autorização.
Para obter mais informações, consulte Autenticação com o Amazon Location Service
-
- Consultas
-
Define a localização e o raio de pesquisa da consulta.
-
QueryPosition: especifica as coordenadas de longitude e latitude. -
QueryRadius: define o raio de pesquisa ao redor das coordenadas especificadas.
Para obter mais informações, consulte Consulta e desvios
-
- Refinar resultados
-
Filtra os resultados para restringir os critérios de pesquisa.
-
Filter: aplica filtros como categorias, cadeias de negócios ou tipos de alimentos.
Para obter mais detalhes, consulte Filtrar
-
- Internacionalização e localização
-
Opções para personalizar o idioma e aplicar uma visão política aos resultados.
-
Language: especifica o idioma dos resultados. -
PoliticalView: aplica uma visão política que reflete reivindicações territoriais.
Para obter mais informações, consulte Localização e internacionalização
-
- Atributos adicionais
-
Solicita dados extras, como informações de fuso horário.
-
AdditionalFeatures: opção para solicitar detalhes adicionais, como informações sobre fuso horário.
Para obter mais informações, consulte Recursos adicionais
-
Sobre a resposta
A resposta da API Pesquisar as proximidades fornece resultados detalhados que correspondem à consulta, incluindo localização, detalhes de endereço, cadeia de negócios, contatos, fonemas, fuso horário e horário de funcionamento. Para obter mais detalhes, consulte a Referência da API de Pesquisar nas proximidades.
A resposta inclui os seguintes dados principais:
- Endereço e detalhes relacionados
-
Informações abrangentes de endereço do local retornado.
-
Address: inclui detalhes completos do endereço, como país e rua.
-
- Tipos e categorias de locais
-
Descreve o tipo e a categoria do local retornado.
-
Categories: categorias que descrevem o local, por exemplo, Restaurantes e Escolas. -
FoodTypes: tipos de alimentos disponíveis em restaurantes ou lanchonetes. -
BusinessChains: indica todas as cadeias de negócios associadas.
-
- Detalhes adicionais
-
Informações adicionais relacionadas ao local, conforme solicitado.
-
Contacts: lista e-mails, números de telefone e sites. -
OpeningHours: especifica o horário de funcionamento do local. -
Phonemes: fornece representações fonéticas dos componentes do endereço. -
TimeZone: inclui informações de fuso horário do local.
-
