Search

Geocoding and reverse Geocoding

Applications developed with the Sygic iOS SDK can perform offline and online geocoding, which allows geocode and reverse geocode requests to be performed event without an active data connection. This is done automatically when an active data connection is not available, as long as the map and database information have been previously downloaded.

class SearchViewController: UIViewController {
    var reverseSearchResults: [SYReverseSearchResult] = []

    // Create an instance of SYReverseSearch
    let reverseSearch = SYReverseSearch()

    // Example of your method to perform reverse geocoding for specific coordinate
    func reverseSearch(at coordinate: SYGeoCoordinate) {

        // Perform request for coordinate
        self.reverseSearch.reverseSearch(with: coordinate) { [weak self] (reverseSearchResults) in
            self?.reverseSearchResults = reverseSearchResults

            // Example of accessing reverse geocoding results description
            if let firstResult = reverseSearchResults.first {
                let resultDescription = firstResult.resultDescription // Contains textual description of the found result

                let countryIsoCode = resultDescription.countryIso
                let city = resultDescription.city
                let street = resultDescription.street
                let houseNumber = resultDescription.houseNumber
            }
        }
    }
}

Search

The Sygic iOS SDK includes a Search API which provides functionality to search and obtain more information about places in the real world.
Note that offline search is supported when a data connection is unavailable, if the data required to perform the search has been previously downloaded. Geocoding APIs resolve a free-formatted text query to an SYGeoCoordinates, while reverse geocoding APIs resolve from an SYGeoCoordinates to geographic data.

Whether online or offline search is executed depends on active data connection and value set in SYOnlineSession.shared().onlineMapsEnabled

class SearchViewController: UIViewController {

    var searchResults = [SYSearchResult]()

    // Get an instance of SYSearch. Don't use local variable otherwise you'll loose reference before results serach results come in
    let search = SYSearch()
    func search(for searchQuery: String, at location: SYGeoCoordinate) {
        // Create SYSearchRequest with string to search for and location where the search should focus
        let searchRequest = SYSearchRequest(query: searchQuery, atLocation: location)
        searchRequest.maxResultsCount = 5 // Optionally: specify maximum number of results

        // Perform search request.
        self.search.start(searchRequest) { [weak self] (searchResults, resultState) in
            if resultState == .error {
                // Handle error state
            }

            // Process results
            self?.searchResults = searchResults
        }
    }
}