文件 AWS 開發套件範例 GitHub 儲存庫中有更多可用的 [AWS SDK 範例](https://github.com/awsdocs/aws-doc-sdk-examples)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 使用適用於 Java 2.x 的 SDK 的 Location Service Places 範例 下列程式碼範例示範如何使用 AWS SDK for Java 2.x 搭配 Location Service Places 執行動作和實作常見案例。 *Actions* 是大型程式的程式碼摘錄，必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數，但您可以在其相關情境中查看內容中的動作。 每個範例均包含完整原始碼的連結，您可在連結中找到如何設定和執行內容中程式碼的相關指示。 **Topics** + [動作](#actions) ## 動作 ### `ReverseGeocode` 以下程式碼範例顯示如何使用 `ReverseGeocode`。 **SDK for Java 2.x** GitHub 上提供更多範例。尋找完整範例，並了解如何在 [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()) ); }); } ``` + 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [ReverseGeocode](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/ReverseGeocode)。 ### `SearchNearby` 以下程式碼範例顯示如何使用 `SearchNearby`。 **SDK for Java 2.x** GitHub 上提供更多範例。尋找完整範例，並了解如何在 [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("-------------------------"); }); }); } ``` + 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [SearchNearby](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchNearby)。 ### `SearchText` 以下程式碼範例顯示如何使用 `SearchText`。 **SDK for Java 2.x** GitHub 上提供更多範例。尋找完整範例，並了解如何在 [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); }); } ``` + 如需 API 詳細資訊，請參閱《AWS SDK for Java 2.x API 參考》**中的 [SearchText](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchText)。