Weitere AWS SDK-Beispiele sind im GitHub Repo [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) verfügbar.
Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
# Codebeispiele für Location Service Places mit AWS SDKs
Die folgenden Codebeispiele zeigen Ihnen, wie Sie Amazon Location Service Places mit einem AWS Software Development Kit (SDK) verwenden.
*Aktionen* sind Codeauszüge aus größeren Programmen und müssen im Kontext ausgeführt werden. Während Aktionen Ihnen zeigen, wie Sie einzelne Service-Funktionen aufrufen, können Sie Aktionen im Kontext der zugehörigen Szenarien anzeigen.
**Weitere -Quellen**
+ **[Entwicklerhandbuch für Location Service Places](https://docs.aws.amazon.com/location/latest/developerguide/places.html)** – Weitere Informationen zu Location Service Places.
+ **[API-Referenz für Location Service Places](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)** – Details zu allen verfügbaren Aktionen von Location Service Places.
+ **[AWS Developer Center](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** — Codebeispiele, die Sie nach Kategorie oder Volltextsuche filtern können.
+ **[AWS SDK-Beispiele](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub Repo mit vollständigem Code in bevorzugten Sprachen. Enthält Anleitungen zum Einrichten und Ausführen des Codes.
**Contents**
+ [Grundlagen](geo-places_code_examples_basics.md)
+ [Aktionen](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)
# Grundlegende Beispiele für Location Service Places mit AWS SDKs
Die folgenden Codebeispiele zeigen, wie Sie die Grundlagen von Amazon Location Service Places mit verwenden können AWS SDKs.
**Contents**
+ [Aktionen](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)
# Aktionen für Location Service Places mit AWS SDKs
Die folgenden Codebeispiele zeigen, wie einzelne Location Service Places-Aktionen mit ausgeführt AWS SDKs werden. Jedes Beispiel enthält einen Link zu GitHub, wo Sie Anweisungen zum Einrichten und Ausführen des Codes finden.
Die folgenden Beispiele enthalten nur die am häufigsten verwendeten Aktionen. Eine vollständige Liste finden Sie in der [API-Referenz zu Amazon Location Service](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)
# `ReverseGeocode`Mit einem AWS SDK verwenden
Das folgende Codebeispiel zeigt, wie es verwendet wird`ReverseGeocode`.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/location#code-examples) einrichten und ausführen.
```
/**
* 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())
);
});
}
```
+ Einzelheiten zur API finden Sie [ReverseGeocode](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/ReverseGeocode)in der *AWS SDK for Java 2.x API-Referenz*.
------
# `SearchNearby`Mit einem AWS SDK verwenden
Das folgende Codebeispiel zeigt, wie es verwendet wird`SearchNearby`.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/location#code-examples) einrichten und ausführen.
```
/**
* 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("-------------------------");
});
});
}
```
+ Einzelheiten zur API finden Sie [SearchNearby](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchNearby)in der *AWS SDK for Java 2.x API-Referenz*.
------
# `SearchText`Mit einem AWS SDK verwenden
Das folgende Codebeispiel zeigt, wie es verwendet wird`SearchText`.
------
#### [ Java ]
**SDK für Java 2.x**
Es gibt noch mehr dazu GitHub. Hier finden Sie das vollständige Beispiel und erfahren, wie Sie das [AWS -Code-Beispiel-](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2/example_code/location#code-examples) einrichten und ausführen.
```
/**
* 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);
});
}
```
+ Einzelheiten zur API finden Sie [SearchText](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchText)in der *AWS SDK for Java 2.x API-Referenz*.
------