expo-gaode-map

English

简体中文

English

简体中文

Appearance

expo-gaode-mapAMap React Native Component

Complete AMap solution built with Expo Modules

Get Started
View on GitHub
expo-gaode-map
🗺️

Complete Map Features

Support multiple map types, gesture control, camera operations

📍

Accurate Location

Continuous location, single location, coordinate conversion

📥

Offline Maps 🆕

City map download management, real-time progress monitoring, storage management, works without network

🎨

Rich Overlays

Circle, Marker, Polyline, Polygon and more

📝

TypeScript Support

Complete TypeScript type definitions

🔧

Modular Design

Clear architecture, easy to maintain and extend

📱

Cross-platform

Support both Android and iOS platforms

⚡

New & Old Architecture

Full support for React Native new architecture (Fabric & TurboModules) and legacy architecture

Quick Start ​

Version Compatibility

  • If you are using Expo SDK 54+, please install the Latest version.
  • If you are using Expo SDK 53 or lower (e.g., 50, 51, 52, 53), please use the V1 version (Tag: v1).
    bash
    npm install expo-gaode-map@v1
    Note: Apart from lacking World Map functionality, the V1 version shares the same API as V2 (Latest).

Installation ​

bash
npm install expo-gaode-map

Basic Usage ​

tsx
import { MapView, ExpoGaodeMapModule } from 'expo-gaode-map';

// If native keys are configured via Config Plugin or manually, you do not need
// to pass androidKey / iosKey in JavaScript.
// Only needed for Web API features:
// ExpoGaodeMapModule.initSDK({ webKey: 'your-web-api-key' });

// Only if native keys are not configured:
// ExpoGaodeMapModule.initSDK({
//   androidKey: 'your-android-api-key',
//   iosKey: 'your-ios-api-key',
// });

// Use map component
<MapView
  style={{ flex: 1 }}
  initialCameraPosition={{
    target: { latitude: 39.9, longitude: 116.4 },
    zoom: 10,
  }}
  myLocationEnabled={true}
/>

Why expo-gaode-map? ​

  • ✅ Built with Expo Modules: Modern development experience
  • ✅ Feature Complete: Cover main AMap features
  • ✅ Well Documented: Detailed documentation in Chinese and English
  • ✅ Actively Maintained: Continuous updates and community support
  • ✅ Open Source: MIT license, free for commercial use

Community ​