> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/android/ja/search/llms.txt)

# Search by Coordinate

The Place Autocomplete returns place suggestions in response to user search queries, including specifying numeric location. The Search SDK will help you to implement such functionality in a few lines of code.

## User experience

This use case allows users to search for places by the coordinate and pick appropriate from the returned suggestions.

We have a [ready-made sample app](https://github.com/mapbox/mapbox-search-android/blob/main/MapboxSearch/sample/src/main/java/com/mapbox/search/sample/) that you can try in Android Studio with Place Autocomplete and other scenarios. We encourage you to install and try it for yourself.

> **Related content (example): [Full example of Place Autocomplete integration](https://docs.mapbox.com/android/ja/search/examples/place-autocomplete/)**
> 
> Learn how to integrate the Place Autocomplete with Maps SDK and Search UI components in a sample app.

## Integration

Place Autocomplete provides coroutine-based API. In the following integration steps, we assume that you are familiar with the Kotlin coroutines and your Android project has `Kotlin-ktx` dependencies added. See the [Kotlin coroutines guide](https://developer.android.com/topic/libraries/architecture/coroutines) for more information.

> **Related content (guide): [Installation guide](https://docs.mapbox.com/android/ja/search/guides/install/)**
> 
> Before using any of Mapbox's Search products, you need to do some common installation steps. Follow this guide to complete the installation, then continue with the steps below.

1.  The main entrypoint class is called `PlaceAutocomplete`, you will need to instantiate this class first:

```kotlin
val placeAutocomplete = PlaceAutocomplete.create(mapboxAccessToken)
```

2.  Retrieve autocomplete suggestions using [`reverse()`](https://docs.mapbox.com/android/search/api/place-autocomplete/2.28.2/place-autocomplete/com.mapbox.search.autocomplete/-place-autocomplete/reverse.html) function. As mentioned above, Place Autocomplete provides coroutine-based API, and `suggestions()` is a suspend function which [should be called only from a coroutine or another suspend function](https://developer.android.com/topic/libraries/architecture/coroutines). The following code example assumes it was called from the activity's `lifecycleScope`:

```kotlin
lifecycleScope.launchWhenCreated {
    val response = placeAutocomplete.reverse(point = Point.fromLngLat(-77.03399849939174, 38.89992081005698))
}
```

3.  Process the Place Autocomplete response. The `reverse()` function returns either an error or a suggestions list:

```kotlin
response.onValue { suggestions: List<PlaceAutocompleteSuggestion> ->
    processSuggestions(suggestions)
}.onError { e ->
    // process error
}
```

4.  When a user has selected a suggestion, call `select()` function. This function returns `PlaceAutocompleteResult` object that provides detailed information about the place. Also, `select()` function ends billing session, so it's obligatory to call it every time your users select suggestions.

```kotlin
val selectedSuggestion = pickSuggestion(suggestions)

val selectionResponse = placeAutocomplete.select(selectedSuggestion)
selectionResponse.onValue { result ->
    // process result
}.onError { e ->
    // process error
}
```

> **Related content (glossary): [API Reference](https://docs.mapbox.com/android/ja/search/api-reference/)**
> 
> For more information, see the full API reference for the Place Autocomplete for Android.

## Search by Coordinate Pricing

There is no separate charge if you choose to use Mapbox Search SDK for Android to access our APIs, you only pay by the Search API usage.

Usage of the Search by Coordinate is measured in monthly API requests. Details about the number of API requests included in the free tier and the cost per request beyond what is included in the free tier are available on the [pricing page](https://www.mapbox.com/pricing/#search-api-requests).