D'autres exemples de AWS SDK sont disponibles dans le référentiel [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # Exemples d’emplacements Location Service avec le kit SDK pour Java 2.x Les exemples de code suivants vous montrent comment effectuer des actions et implémenter des scénarios courants à l'aide de AWS SDK for Java 2.x with Location Service Places. Les *actions* sont des extraits de code de programmes plus larges et doivent être exécutées dans leur contexte. Alors que les actions vous indiquent comment appeler des fonctions de service individuelles, vous pouvez les voir en contexte dans leurs scénarios associés. Chaque exemple inclut un lien vers le code source complet, où vous trouverez des instructions sur la configuration et l’exécution du code en contexte. **Topics** + [Actions](#actions) ## Actions ### `ReverseGeocode` L'exemple de code suivant montre comment utiliser`ReverseGeocode`. **SDK pour Java 2.x** Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](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()) ); }); } ``` + Pour plus de détails sur l'API, reportez-vous [ReverseGeocode](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/ReverseGeocode)à la section *Référence des AWS SDK for Java 2.x API*. ### `SearchNearby` L'exemple de code suivant montre comment utiliser`SearchNearby`. **SDK pour Java 2.x** Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](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("-------------------------"); }); }); } ``` + Pour plus de détails sur l'API, reportez-vous [SearchNearby](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchNearby)à la section *Référence des AWS SDK for Java 2.x API*. ### `SearchText` L'exemple de code suivant montre comment utiliser`SearchText`. **SDK pour Java 2.x** Il y en a plus à ce sujet GitHub. Trouvez l’exemple complet et découvrez comment le configurer et l’exécuter dans le [référentiel d’exemples de code AWS](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); }); } ``` + Pour plus de détails sur l'API, reportez-vous [SearchText](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchText)à la section *Référence des AWS SDK for Java 2.x API*.