Doc AWS SDK Examples GitHub リポジトリには、他にも SDK の例があります。 [AWS](https://github.com/awsdocs/aws-doc-sdk-examples)
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# AWS SDKsコード例
次のコード例は、 AWS Software Development Kit (SDK) で Amazon Location Service Places を使用する方法を示しています。
*アクション*はより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
**その他のリソース**
+ **[ Location Service Places デベロッパーガイド](https://docs.aws.amazon.com/location/latest/developerguide/places.html)** – Location Service Places に関する詳細情報。
+ **[Location Service Places API リファレンス](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)** – 使用可能なすべての Location Service Places アクションに関する詳細。
+ **[AWS デベロッパーセンター](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** – カテゴリまたは全文検索でフィルタリングできるコード例。
+ **[AWS SDK の例](https://github.com/awsdocs/aws-doc-sdk-examples)** – 完全なコードを優先言語で含む GitHub リポジトリ。コードの設定と実行に関する説明が記載されています。
**Contents**
+ [基本](geo-places_code_examples_basics.md)
+ [アクション](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)
# AWS SDKsの基本的な例
以下のコード例は、 AWS SDK で Amazon Location Service Places を使用する基本的な方法を示しています。
**Contents**
+ [アクション](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)
# AWS SDKsアクション
次のコード例は、 AWS SDKs を使用して個々の Location Service Places アクションを実行する方法を示しています。それぞれの例には、GitHub へのリンクがあり、そこにはコードの設定と実行に関する説明が記載されています。
以下の例には、最も一般的に使用されるアクションのみ含まれています。完全なリストについては、「[Amazon Location Service Places API リファレンス](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)
# AWS SDK `ReverseGeocode`で を使用する
次の例は、`ReverseGeocode` を使用する方法を説明しています。
------
#### [ Java ]
**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)」を参照してください。
------
# AWS SDK `SearchNearby`で を使用する
次の例は、`SearchNearby` を使用する方法を説明しています。
------
#### [ Java ]
**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)」を参照してください。
------
# AWS SDK `SearchText`で を使用する
次の例は、`SearchText` を使用する方法を説明しています。
------
#### [ Java ]
**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)」を参照してください。
------