Search

Autocomplete and Geocoding

Applications developed with the Sygic SDK can use geocoding to transform textual query into geographical information. With the SearchManager you can perform three basic actions : Geocoding, ReverseGeocoding and Autocomplete. Please note that if you use the online services, you might want to define to send a request once every 300ms or so, otherwise some requests might end up with an error TOO_MANY_REQUESTS. The autocomplete engine works with few simple steps:

1. Create a SearchRequest

   final GeoCoordinates geoCoordinates = new GeoCoordinates(42.673, 19.144);
   final SearchRequest request = new SearchRequest("text", geoCoordinates);

2. Get the SearchManager's instance and call autocomplete on the instance using the search request and an AutocompleteResultListener that can also be created beforehand.

   SearchManagerProvider.getInstance(new InitializationCallback<SearchManager>() {
       @Override
       public void onInstance(@NonNull SearchManager searchManager) {
           searchManager.autocomplete(request, new SearchManager.AutocompleteResultListener() {
               @Override
               public void onAutocomplete(@NotNull List<AutocompleteResult> list) {
                   //do something with the results
               }
               @Override
               public void onAutcompleteError(@NotNull SearchManager.ErrorCode errorCode) {
               }
           });
       }
   
       @Override
       public void onError(int i) {
       }
   });

Online vs. offline

Whether online or offline search is executed depends on active data connection and value set in OnlineManager's enableOnlineMapStreaming(true/false). For offline search, you need to have offline maps downloaded. There's no fallback from online to offline search, so you will need to change the online status depending on the device's connection.

OnlineManagerProvider.getInstance(new InitializationCallback<OnlineManager>() {
    @Override
    public void onInstance(@NonNull OnlineManager onlineManager) {
        onlineManager.enableOnlineMapStreaming(true);
        onlineManager.addOnlineStatusListener(new OnlineManager.OnlineStatusListener() {
            @Override
            public void onStatusChanged(int i) {
            }
        });
    }
  @Override
  public void onError(int i) {
  }
});

Geocoding

After finding the desired result in autocomplete, you can take its locationID and call Geocode with it to get more precise information about the location. If you do not need to use autocomplete and have the full string that you want to search for, just use Geocode straight away.

mSearchManager.geocode(request, new SearchManager.GeocodingResultsListener() {
    @Override
    public void onGeocodingResultsError(@NotNull SearchManager.ErrorCode errorCode) {
    }
    @Override
    public void onGeocodingResults(@NotNull List<? extends GeocodingResult> list) {
        // do something with the results
    }
});

Places

You can search Places (POI) near a location via the PlacesManager api. By defining a PlaceCategories, you can search places of certain type (eg. find restaurants around user). All places can be searched by passing PlaceCategories.Unknown.

PlacesManagerProvider.getInstance(new InitializationCallback<PlacesManager>() {
    @Override
    public void onInstance(@NonNull PlacesManager placesManager) {
        GeoCoordinates position = new GeoCoordinates(42.673, 19.144);
        PlaceRequest request = new PlaceRequest(position, /*radius*/ 200, /*maxResultCount*/ 20, 
                                        /*prefLanguage*/ "en-us", PlaceCategories.Restaurant, PlaceRequestFilterType.CATEGORY);

        placesManager.searchPlaces(request, new PlacesManager.PlacesListener() {
            @Override
            public void onPlacesLoaded(@NotNull List<Place> list) {
                // process places
            }
            @Override
            public void onPlacesError(@NotNull PlacesManager.ErrorCode errorCode) {
            }
        });
    }
    @Override
    public void onError(int i) {
    }
});

Reverse geocoding

Reverse geocoding is the opposite process to geocoding, meaning you query by geographical location and receive textual address of the location. You can define a filter if you do not want to take walkways into account or pass it an emptySet.

mReverseGeocoder.reverseGeocode(new GeoCoordinates(48.14085, 17.1201), Collections.emptySet(), new ReverseGeocoder.ReverseGeocodingResultListener() {
    @Override
    public void onReverseGeocodingResultError(@NotNull SearchManager.ErrorCode errorCode) {
    }

    @Override
    public void onReverseGeocodingResult(@NotNull List<? extends ReverseGeocodingResult> list) {
        for (final ReverseGeocodingResult reverseSearchResult : list) {
          String country = reverseSearchResult.getNames().getCountryIso();
          String city = reverseSearchResult.getNames().getCity();
          String street = reverseSearchResult.getNames().getStreet();
        }
    }
});