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](places-pricing.md) para obter detalhes sobre os custos associados aos resultados armazenados.
Para obter mais informações, consulte [SearchNearby](https://docs.aws.amazon.com/location/latest/APIReference/API_geoplaces_SearchNearby.html) 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](https://docs.aws.amazon.com/location/latest/developerguide/search-nearby-how-to.html).
## 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](access.md)
**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](places-querying-biasing.md)
**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](places-filtering.md)
**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](places-localization-internationalization.md)
**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](additional-features.md)
## 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.