Skip to Content
Introduction

SDK Android Library

SDK Android Library is a Software Development Kit (SDK) meticulously crafted for android developers, aiming to empower them with the ability to weave sophisticated mapping functionalities into their android applications, drawing inspiration from the innovative Lazarillo navigation app. This comprehensive toolkit extends beyond mere mapping to offer an array of tools and APIs that support the development of interactive maps, the crafting of custom routes, the placement of informative markers, and a plethora of additional features. It’s designed not only to augment the user experience and enhance android application functionality but also to streamline the integration process, ensuring developers have access to a robust, flexible, and intuitive platform. By leveraging this SDK, developers can create more engaging and user-friendly android applications that cater to the navigational needs of their users, thereby facilitating a more immersive and interactive digital experience.

Expo Qatar 2023 with zoom

Features

Custom styles with no code

Why this matters: Brand consistency is crucial for apps. Instead of requiring code changes and app updates for style changes, styles are managed remotely. This allows rapid iteration, A/B testing, and brand updates without redeploying your app.

When loading your space’s information into our system, we can apply different styles without you having to modify your code. It updates remotely, and we can adapt it to your needs. We have full control over the map, so everything from colors, sizes, icons, it’s all customizable according to your designs or requirements.

Base style

If you don’t have designers or a design guide, or if you like the base design we have, you can use it without any issues. Here’s an example of how it looks.

building with base style
Client style - no additional code added

If you want to personalize your maps, you can do so. We control the style remotely, so we can create a style that suits your needs. Here’s the same example location but with a customized style so you can see the difference.

Same building with style 2

Interactive Map

Why interactivity matters: Static maps provide limited value. Interactive maps enable users to explore venues, discover places, and get detailed information through taps and gestures. This transforms maps from simple displays into powerful navigation and discovery tools.

Easily integrate customizable maps into your android application, providing an interactive and dynamic user experience.

Here’s an example of interaction with the map: when clicking on a store, the store’s color changes, and a modal with the selected store’s information is displayed.

Map interaction example

Route Creation

Why route planning is essential: Navigation is a core use case for mapping SDKs. The SDK calculates optimal routes considering accessibility, indoor/outdoor transitions, and multi-floor navigation. Routes are visualized on the map with customizable styling (completed vs upcoming segments) and provide turn-by-turn guidance.

Allows users to create specific routes on the map, including customizable waypoints and paths, facilitating the planning of journeys and movements. Routes support both indoor and outdoor navigation, with automatic floor transitions and accessibility-aware routing. A built-in route animation controller can play back any route step by step with configurable speed, floor-transition pauses, and waypoint rotation, enabling preview and demo modes without writing custom animation logic.

Expo Qatar 2023 with zoom

Marker Placement

Why markers matter: Markers help users identify points of interest, stores, and key locations. The SDK supports both custom markers (for arbitrary locations) and place markers (for venues with logos/text). Markers are automatically managed based on floor visibility, ensuring users only see relevant markers.

Enables the addition of markers on the map to point out places of interest or key locations, improving orientation and the delivery of relevant information to users. Markers can display custom icons, place logos, or text labels, and are automatically filtered by floor for indoor venues.

Advanced Marker Customization

The SDK provides LzAnnotationConfiguration and its fluent builder for full control over marker appearance, achieving feature parity with the iOS SDK. Customization options include:

  • Icon styling: Color tinting, scaling, and shape control (circle, square, or rounded rectangle via iconCornerRadius)
  • Text labels: Configurable font size, color, position (top/bottom/left/right), halo outline, and solid background color
  • Image sources: Load icons from a URL, a drawable resource name, or a pre-created Bitmap
  • Background: Draw a colored background behind the icon with borderColor
  • Behavior: Control opacity, drag interaction, and flat/billboard rendering

See the Marker Customization examples for detailed usage.

custom markers example 2

Indoor Location Tracking

Why indoor positioning is challenging: GPS signals are blocked by building materials, making indoor navigation inaccurate. The SDK solves this by combining GPS (outdoor) and Bluetooth beacons (indoor) to provide seamless location tracking. Beacon-based positioning offers 1-3m accuracy indoors, enabling precise navigation within buildings.

Provides accurate indoor positioning using beacon technology, with automatic floor detection and user location display that adapts to multi-floor environments. The SDK automatically switches between GPS and beacon sources based on availability, providing seamless indoor/outdoor transitions.

Place Markers with Smart Floor Management

Why automatic floor management is essential: In multi-floor venues, showing all markers simultaneously creates visual clutter and confusion. Automatic floor-based filtering ensures users only see markers relevant to their current floor, improving map clarity and usability without requiring manual marker management.

Automatically manages place markers based on the current floor being displayed. Markers show/hide intelligently as users navigate between floors, ensuring a clean and relevant map experience. This eliminates the need for manual marker visibility management.

Accessibility Support

Why accessibility matters: Maps must be usable by everyone, including users with visual impairments. The SDK provides comprehensive accessibility support with customizable screen reader texts, proper content descriptions, and configurable visibility settings. This ensures compliance with accessibility standards and provides an inclusive user experience.

Full accessibility support with customizable texts for screen readers. All UI elements include proper content descriptions following Android accessibility guidelines. Accessibility can be configured via AccessibilityConfig objects or by overriding string resources in your app.

Comprehensive API Documentation

Why documentation matters: Well-documented APIs reduce integration time, prevent common mistakes, and help developers understand not just what functions do, but why they exist and when to use them. Our documentation includes code examples, use case explanations, and troubleshooting guides.

Extensive documentation covering all SDK features, including troubleshooting guides and best practices for common implementation scenarios. All public APIs include KDoc comments explaining purpose, parameters, return values, and usage examples.

Getting Started

To get started with the SDK:

  1. Installation - Set up the SDK in your project
  2. Examples - Learn through practical examples
  3. API Reference - Detailed API documentation
  4. Accessibility Guide - Accessibility features and customization
  5. Troubleshooting - Solutions for common issues
  6. FAQ & Troubleshooting - Frequently asked questions and common issues
Last updated on