Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub .
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á.
# Exemplos de código para Location Service Places usando AWS SDKs
Os exemplos de código a seguir mostram como usar o Amazon Location Service Places com um kit de desenvolvimento de AWS software (SDK).
*Ações* são trechos de código de programas maiores e devem ser executadas em contexto. Embora as ações mostrem como chamar perfis de serviço individuais, você pode ver as ações no contexto em seus cenários relacionados.
**Mais atributos**
+ **[Guia do desenvolvedor do Location Service Places](https://docs.aws.amazon.com/location/latest/developerguide/places.html)**: mais informações sobre o Location Service Places.
+ **[Referência de API do Location Service Places](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)**: detalhes sobre todas as ações disponíveis do Location Service Places.
+ **[AWS Centro do desenvolvedor](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** — exemplos de código que você pode filtrar por categoria ou pesquisa de texto completo.
+ **[AWS Exemplos de SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub repositório com código completo nos idiomas preferidos. Inclui instruções para configurar e executar o código.
**Contents**
+ [Conceitos básicos](geo-places_code_examples_basics.md)
+ [Ações](geo-places_code_examples_actions.md)
+ [`ReverseGeocode`](geo-places_example_geo-places_ReverseGeocode_section.md)
+ [`SearchNearby`](geo-places_example_geo-places_SearchNearby_section.md)
+ [`SearchText`](geo-places_example_geo-places_SearchText_section.md)
# Exemplos básicos de Location Service Places usando AWS SDKs
Os exemplos de código a seguir mostram como usar os conceitos básicos do Amazon Location Service Places com AWS SDKs.
**Contents**
+ [Ações](geo-places_code_examples_actions.md)
+ [`ReverseGeocode`](geo-places_example_geo-places_ReverseGeocode_section.md)
+ [`SearchNearby`](geo-places_example_geo-places_SearchNearby_section.md)
+ [`SearchText`](geo-places_example_geo-places_SearchText_section.md)
# Ações para Location Service Places usando AWS SDKs
Os exemplos de código a seguir demonstram como realizar ações individuais do Location Service Places com AWS SDKs. Cada exemplo inclui um link para GitHub, onde você pode encontrar instruções para configurar e executar o código.
Os exemplos a seguir incluem apenas as ações mais utilizadas. Consulte uma lista completa na [Referência de API do Amazon Location Service Places](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html).
**Topics**
+ [`ReverseGeocode`](geo-places_example_geo-places_ReverseGeocode_section.md)
+ [`SearchNearby`](geo-places_example_geo-places_SearchNearby_section.md)
+ [`SearchText`](geo-places_example_geo-places_SearchText_section.md)
# Use `ReverseGeocode` com um AWS SDK
O código de exemplo a seguir mostra como usar `ReverseGeocode`.
------
#### [ Java ]
**SDK para Java 2.x**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/location#code-examples).
```
/**
* Performs reverse geocoding using the AWS Geo Places API.
* Reverse geocoding is the process of converting geographic coordinates (latitude and longitude) to a human-readable address.
* This method uses the latitude and longitude of San Francisco as the input, and prints the resulting address.
*/
public CompletableFuture reverseGeocode() {
double latitude = 37.7749; // San Francisco
double longitude = -122.4194;
logger.info("Use latitude 37.7749 and longitude -122.4194");
// AWS expects [longitude, latitude].
List queryPosition = List.of(longitude, latitude);
ReverseGeocodeRequest request = ReverseGeocodeRequest.builder()
.queryPosition(queryPosition)
.build();
CompletableFuture futureResponse =
getGeoPlacesClient().reverseGeocode(request);
return futureResponse.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause();
if (cause instanceof software.amazon.awssdk.services.geoplaces.model.ValidationException) {
throw new CompletionException("A validation error occurred: " + cause.getMessage(), cause);
}
throw new CompletionException("Error performing reverse geocoding", exception);
}
response.resultItems().forEach(result ->
logger.info("The address is: " + result.address().label())
);
});
}
```
+ Para obter detalhes da API, consulte [ReverseGeocode](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/ReverseGeocode)a *Referência AWS SDK for Java 2.x da API*.
------
# Use `SearchNearby` com um AWS SDK
O código de exemplo a seguir mostra como usar `SearchNearby`.
------
#### [ Java ]
**SDK para Java 2.x**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/location#code-examples).
```
/**
* Performs a nearby places search based on the provided geographic coordinates (latitude and longitude).
* The method sends an asynchronous request to search for places within a 1-kilometer radius of the specified location.
* The results are processed and printed once the search completes successfully.
*/
public CompletableFuture searchNearBy() {
double latitude = 37.7749; // San Francisco
double longitude = -122.4194;
List queryPosition = List.of(longitude, latitude);
// Set up the request for searching nearby places.
SearchNearbyRequest request = SearchNearbyRequest.builder()
.queryPosition(queryPosition) // Set the position
.queryRadius(1000L) // Radius in meters (1000 meters = 1 km).
.build();
return getGeoPlacesClient().searchNearby(request)
.whenComplete((response, exception) -> {
if (exception != null) {
Throwable cause = exception.getCause();
if (cause instanceof software.amazon.awssdk.services.geoplaces.model.ValidationException) {
throw new CompletionException("A validation error occurred: " + cause.getMessage(), cause);
}
throw new CompletionException("Error performing place search", exception);
}
// Process the response and print the results.
response.resultItems().forEach(result -> {
logger.info("Place Name: " + result.placeType().name());
logger.info("Address: " + result.address().label());
logger.info("Distance: " + result.distance() + " meters");
logger.info("-------------------------");
});
});
}
```
+ Para obter detalhes da API, consulte [SearchNearby](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchNearby)a *Referência AWS SDK for Java 2.x da API*.
------
# Use `SearchText` com um AWS SDK
O código de exemplo a seguir mostra como usar `SearchText`.
------
#### [ Java ]
**SDK para Java 2.x**
Tem mais sobre GitHub. Encontre o exemplo completo e saiba como configurar e executar no [AWS Code Examples Repository](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/location#code-examples).
```
/**
* Searches for a place using the provided search query and prints the detailed information of the first result.
*
* @param searchQuery the search query to be used for the place search (ex, coffee shop)
*/
public CompletableFuture searchText(String searchQuery) {
double latitude = 37.7749; // San Francisco
double longitude = -122.4194;
List queryPosition = List.of(longitude, latitude);
SearchTextRequest request = SearchTextRequest.builder()
.queryText(searchQuery)
.biasPosition(queryPosition)
.build();
return getGeoPlacesClient().searchText(request)
.thenCompose(response -> {
if (response.resultItems().isEmpty()) {
logger.info("No places found.");
return CompletableFuture.completedFuture(null);
}
// Get the first place ID
String placeId = response.resultItems().get(0).placeId();
logger.info("Found Place with id: " + placeId);
// Fetch detailed info using getPlace
GetPlaceRequest getPlaceRequest = GetPlaceRequest.builder()
.placeId(placeId)
.build();
return getGeoPlacesClient().getPlace(getPlaceRequest)
.thenAccept(placeResponse -> {
logger.info("Detailed Place Information:");
logger.info("Name: " + placeResponse.placeType().name());
logger.info("Address: " + placeResponse.address().label());
if (placeResponse.foodTypes() != null && !placeResponse.foodTypes().isEmpty()) {
logger.info("Food Types:");
placeResponse.foodTypes().forEach(foodType -> {
logger.info(" - " + foodType);
});
} else {
logger.info("No food types available.");
}
logger.info("-------------------------");
});
})
.exceptionally(exception -> {
Throwable cause = exception.getCause();
if (cause instanceof software.amazon.awssdk.services.geoplaces.model.ValidationException) {
throw new CompletionException("A validation error occurred: " + cause.getMessage(), cause);
}
throw new CompletionException("Error performing place search", exception);
});
}
```
+ Para obter detalhes da API, consulte [SearchText](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchText)a *Referência AWS SDK for Java 2.x da API*.
------