Skip to main content

React Native Places Autocomplete

react-native-places-autocomplete

A provider-agnostic React Native autocomplete component for searching addresses and places. Supports multiple built-in geocoding providers including OpenStreetMap (free), OpenCage, Google Places, Mapbox, LocationIQ, Geoapify, HERE, and TomTom, or use any custom API. Easy to integrate, fully customizable, and lightweight.

npm versionnpm downloadslicensestars

Supported ProvidersSupported Providers

Try it on Expo Snack

Overview​

@julekgwa/react-native-places-autocomplete is a React Native component that provides a customizable location search and autocomplete interface. It supports multiple geocoding providers out of the box:

  • OpenStreetMap (Nominatim)
  • Google Places
  • Mapbox
  • Geoapify
  • LocationIQ
  • HERE
  • TomTom
  • OpenCage

Key Features​

  • 🌍 Multiple Providers: Support for various geocoding services with no additional dependencies
  • 🎨 Fully Customizable: Style every aspect of the component to match your app's design
  • 🔍 Recent Searches: Built-in support for recent search history
  • ⚡️ Performance Optimized: Debounced API calls and optimized rendering
  • 🛠 TypeScript Support: Built with TypeScript for a better development experience

Quick Start​

import { LocationAutocomplete } from '@julekgwa/react-native-places-autocomplete';

export default function App() {
  return (
    <LocationAutocomplete
      provider="openstreetmap" // No API key required for OpenStreetMap
      query={{
        limit: 5,
      }}
      onLocationSelect={(location) => {
        console.log('Selected location:', location);
      }}
    />
  );
}

See the Getting Started guide for complete documentation of available props and examples.

Installation​

npm install @julekgwa/react-native-places-autocomplete
# or using yarn
yarn add @julekgwa/react-native-places-autocomplete

For complete installation instructions, see the Getting Started Guide.