Ada lebih banyak contoh AWS SDK yang tersedia di repo Contoh [SDK AWS Doc](https://github.com/awsdocs/aws-doc-sdk-examples). GitHub
Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Contoh kode untuk Location Service Places menggunakan AWS SDKs
Contoh kode berikut menunjukkan cara menggunakan Amazon Location Service Places dengan AWS software development kit (SDK).
*Tindakan* merupakan kutipan kode dari program yang lebih besar dan harus dijalankan dalam konteks. Sementara tindakan menunjukkan cara memanggil fungsi layanan individual, Anda dapat melihat tindakan dalam konteks dalam skenario terkait.
**Sumber daya lainnya**
+ **[Panduan Pengembang Location Service Places](https://docs.aws.amazon.com/location/latest/developerguide/places.html)** — Informasi lebih lanjut tentang Location Service Places.
+ **[Referensi API Location Service Places](https://docs.aws.amazon.com/location/latest/APIReference/Welcome.html)** — Detail tentang semua tindakan Location Service Places yang tersedia.
+ **[AWS Pusat Pengembang](https://aws.amazon.com/developer/code-examples/?awsf.sdk-code-examples-product=product%23)** - Contoh kode yang dapat Anda filter berdasarkan kategori atau pencarian teks lengkap.
+ **[AWS Contoh SDK](https://github.com/awsdocs/aws-doc-sdk-examples)** — GitHub repo dengan kode lengkap dalam bahasa pilihan. Termasuk instruksi untuk mengatur dan menjalankan kode.
**Contents**
+ [Hal-hal mendasar](geo-places_code_examples_basics.md)
+ [Tindakan](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)
# Contoh dasar untuk Location Service Places menggunakan AWS SDKs
Contoh kode berikut menunjukkan cara menggunakan dasar-dasar Amazon Location Service Places dengan AWS SDKs.
**Contents**
+ [Tindakan](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)
# Tindakan untuk Lokasi Service Places menggunakan AWS SDKs
Contoh kode berikut menunjukkan cara melakukan tindakan Location Service Places individual dengan AWS SDKs. Setiap contoh menyertakan tautan ke GitHub, di mana Anda dapat menemukan instruksi untuk mengatur dan menjalankan kode.
Contoh berikut hanya mencakup tindakan yang paling umum digunakan. Untuk daftar lengkapnya, lihat [Referensi API 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)
# Gunakan `ReverseGeocode` dengan AWS SDK
Contoh kode berikut menunjukkan cara menggunakan`ReverseGeocode`.
------
#### [ Java ]
**SDK untuk Java 2.x**
Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode 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())
);
});
}
```
+ Untuk detail API, lihat [ReverseGeocode](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/ReverseGeocode)di *Referensi AWS SDK for Java 2.x API*.
------
# Gunakan `SearchNearby` dengan AWS SDK
Contoh kode berikut menunjukkan cara menggunakan`SearchNearby`.
------
#### [ Java ]
**SDK untuk Java 2.x**
Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode 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("-------------------------");
});
});
}
```
+ Untuk detail API, lihat [SearchNearby](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchNearby)di *Referensi AWS SDK for Java 2.x API*.
------
# Gunakan `SearchText` dengan AWS SDK
Contoh kode berikut menunjukkan cara menggunakan`SearchText`.
------
#### [ Java ]
**SDK untuk Java 2.x**
Ada lebih banyak tentang GitHub. Temukan contoh lengkapnya dan pelajari cara mengatur dan menjalankannya di [Repositori Contoh Kode 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);
});
}
```
+ Untuk detail API, lihat [SearchText](https://docs.aws.amazon.com/goto/SdkForJavaV2/geo-places-2020-11-19/SearchText)di *Referensi AWS SDK for Java 2.x API*.
------