Advanced Usage

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
 
<application
android:allowBackup="true"
android:icon="@mipmap/ic_launcher"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:theme="@style/AppTheme"
>
 
<activity
android:name=".MainActivity"
android:exported="true">
 
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
</application>

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
xmlns:android="http://schemas.android.com/apk/res/android"
android:layout_width="match_parent"
android:layout_height="match_parent"
>
 
<EditText
android:id="@+id/query_edit_text"
android:layout_width="match_parent"
android:layout_height="56dp"
android:hint="Where to?"
android:paddingHorizontal="16dp"
/>
 
<com.mapbox.search.ui.view.SearchResultsView
android:id="@+id/search_results_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:layout_marginTop="56dp"
android:paddingVertical="16dp"
/>
</FrameLayout>

import android.Manifest.permission
import android.content.Context
import android.content.pm.PackageManager
import android.os.Bundle
import android.text.Editable
import android.text.TextWatcher
import android.widget.EditText
import android.widget.Toast
import androidx.appcompat.app.AppCompatActivity
import androidx.core.app.ActivityCompat
import androidx.core.content.ContextCompat
import com.mapbox.search.ApiType
import com.mapbox.search.ResponseInfo
import com.mapbox.search.SearchEngine
import com.mapbox.search.SearchEngineSettings
import com.mapbox.search.ServiceProvider
import com.mapbox.search.offline.OfflineResponseInfo
import com.mapbox.search.offline.OfflineSearchEngine
import com.mapbox.search.offline.OfflineSearchEngineSettings
import com.mapbox.search.offline.OfflineSearchResult
import com.mapbox.search.record.HistoryRecord
import com.mapbox.search.result.SearchResult
import com.mapbox.search.result.SearchSuggestion
import com.mapbox.search.ui.view.CommonSearchViewConfiguration
import com.mapbox.search.ui.view.DistanceUnitType
import com.mapbox.search.ui.view.SearchResultsView
 
class MainActivity : AppCompatActivity() {
 
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
 
val accessToken = getString(R.string.mapbox_access_token)
 
val queryEditText = findViewById<EditText>(R.id.query_edit_text)
val searchResultsView = findViewById<SearchResultsView>(R.id.search_results_view)
searchResultsView.initialize(
SearchResultsView.Configuration(
commonConfiguration = CommonSearchViewConfiguration(DistanceUnitType.IMPERIAL)
)
)
 
val searchEngine = SearchEngine.createSearchEngineWithBuiltInDataProviders(
apiType = ApiType.GEOCODING,
settings = SearchEngineSettings(accessToken)
)
 
val offlineSearchEngine = OfflineSearchEngine.create(
OfflineSearchEngineSettings(accessToken)
)
 
val searchEngineUiAdapter = SearchEngineUiAdapter(
view = searchResultsView,
searchEngine = searchEngine,
offlineSearchEngine = offlineSearchEngine,
)
 
searchEngineUiAdapter.addSearchListener(object : SearchEngineUiAdapter.SearchListener {
 
private fun showToast(message: String) {
Toast.makeText(applicationContext, message, Toast.LENGTH_SHORT).show()
}
 
override fun onSuggestionsShown(suggestions: List<SearchSuggestion>, responseInfo: ResponseInfo) {
// not implemented
}
 
override fun onSearchResultsShown(
suggestion: SearchSuggestion,
results: List<SearchResult>,
responseInfo: ResponseInfo
) {
// not implemented
}
 
override fun onOfflineSearchResultsShown(results: List<OfflineSearchResult>, responseInfo: OfflineResponseInfo) {
// not implemented
}
 
override fun onSuggestionSelected(searchSuggestion: SearchSuggestion): Boolean {
return false
}
 
override fun onSearchResultSelected(searchResult: SearchResult, responseInfo: ResponseInfo) {
showToast("SearchResult clicked: ${searchResult.name}")
}
 
override fun onOfflineSearchResultSelected(searchResult: OfflineSearchResult, responseInfo: OfflineResponseInfo) {
showToast("OfflineSearchResult clicked: ${searchResult.name}")
}
 
override fun onError(e: Exception) {
showToast("Error happened: $e")
}
 
override fun onHistoryItemClick(historyRecord: HistoryRecord) {
showToast("HistoryRecord clicked: ${historyRecord.name}")
}
 
override fun onPopulateQueryClick(suggestion: SearchSuggestion, responseInfo: ResponseInfo) {
queryEditText.setText(suggestion.name)
}
 
override fun onFeedbackItemClick(responseInfo: ResponseInfo) {
// not implemented
}
})
 
queryEditText.addTextChangedListener(object : TextWatcher {
 
override fun onTextChanged(s: CharSequence, start: Int, before: Int, after: Int) {
searchResultsView.search(s.toString())
}
 
override fun beforeTextChanged(s: CharSequence, start: Int, count: Int, after: Int) {
// not implemented
}
 
override fun afterTextChanged(e: Editable) { /* not implemented */ }
})
 
if (!isPermissionGranted(permission.ACCESS_FINE_LOCATION)) {
ActivityCompat.requestPermissions(
this,
arrayOf(permission.ACCESS_FINE_LOCATION, permission.ACCESS_COARSE_LOCATION),
PERMISSIONS_REQUEST_LOCATION
)
}
}
 
private companion object {
 
private const val PERMISSIONS_REQUEST_LOCATION = 0
 
fun Context.isPermissionGranted(permission: String): Boolean {
return ContextCompat.checkSelfPermission(
this, permission
) == PackageManager.PERMISSION_GRANTED
}
}
}