Skip to content

Releases: Bugborne-LLC/GeoKode

Release list

0.1.0-alpha01

0.1.0-alpha01 Pre-release
Pre-release

Choose a tag to compare

@DevinDuricka DevinDuricka released this 21 Dec 22:19

GeoKode v0.1.0-alpha01

First alpha release of GeoKode, a Kotlin Multiplatform geocoding library that provides free, native geocoding capabilities for Android and iOS platforms.

Overview

This initial release provides basic geocoding functionality using platform-native implementations:

  • Android: Uses native Geocoder with configurable result limits
  • iOS: Implements CLGeocoder for native iOS geocoding

Features

  • Unified Kotlin Multiplatform API for geocoding
  • Support for both single-string and component-based address inputs
  • Detailed location results including:
    • Latitude/Longitude coordinates
    • Address components
    • Administrative areas
    • Postal codes
    • Country information

Implementation Notes

Android

  • Full implementation with Android Geocoder
  • Supports Android API 21 and above
  • Handles API differences for Android 13+ (Tiramisu)
  • Configurable maximum results (1-5)

iOS

  • Full implementation with iOS CLGeocoder

Known Limitations

  • Future iOS testing paused pending hardware availability
  • Platform-specific rate limits apply
  • No offline support
  • No caching mechanism yet

Installation

Currently available through GitHub Packages. See README for detailed installation instructions.

Future Plans

  • Migration to Maven Central
  • Google Places API integration as optional fallback
  • Reverse geocoding support
  • Caching implementation
  • Additional platform-specific optimizations

Support

If you find this library useful, please consider:

  1. Sponsoring the project to support iOS development
  2. Contributing code or documentation
  3. Reporting issues and providing feedback
  4. Sharing with other developers