React Native アプリにネイティブマップを追加する
React Nativeでexpo-mapsを設定し、Apple MapsとGoogle Maps、共通マーカー、位置情報権限、カメラ操作、Android APIキー、iOSの制限を確認します。
開発ビルドに expo-maps をインストールし、iOS では AppleMaps.View、Android では GoogleMaps.View をレンダリングします。どちらのコンポーネントも同じカメラ、マーカー、位置情報のデータを受け取るため、1つのラッパーで両プラットフォームに対応できます。
React Native の地図チュートリアルの多くは react-native-maps 向けに書かれています。そのため、そこで使われている props は Expo のライブラリにはそのまま使えません。<MapView> のスニペットを expo-maps プロジェクトにコピーすると、カメラを含むあらゆる箇所で型エラーが発生します。
本ガイドでは、expo-maps を使った一連の流れを解説します。具体的には、ライブラリの選定、アプリのビルド、Android API キーの追加、両プラットフォームでの地図のレンダリング、マーカーの追加、ユーザーの現在地を中心にした表示、マーカータップの処理です。また、使用できる機能を左右する iOS のバージョン制限についても取り上げます。Mapbox のベクタータイルやカスタムスタイルを使いたい場合は、Mapbox を使った React Native マップの作成を参照してください。
重要なポイント
- expo-maps は
AppleMaps.ViewとGoogleMaps.Viewの2つのコンポーネントを通じて、iOS では Apple Maps、Android では Google Maps を表示します。iOS での Google Maps はサポートしていません。 - expo-maps は開発ビルドで実行します。Apple Maps には API キーが不要ですが、Android では app.json の
android.config.googleMaps.apiKeyに Google Maps のキーを設定し、再ビルドする必要があります。 cameraPositionが設定するのは地図の初期位置だけです。後からカメラを動かすには、地図の ref に対してsetCameraPositionを呼び出します。- Expo のドキュメントでは expo-maps の最小要件を iOS 17 としています。ただし、
onMarkerClickなどのマーカータップのコールバックには iOS 18 が必要です。
expo-maps と react-native-maps のどちらを使うべきか
すでに開発ビルドを使用している Expo プロジェクトであれば、expo-maps を選びましょう。iOS で Google Maps が必要な場合や、Expo Go 上で動作させる必要がある場合は react-native-maps を選びます。expo-maps は Expo 公式の地図ライブラリで、iOS では SwiftUI、Android では Jetpack Compose を通じてレンダリングします。react-native-maps はコミュニティによってメンテナンスされているライブラリで、複数の地図プロバイダーで動作する単一の MapView API を提供します。
| expo-maps | react-native-maps | |
|---|---|---|
| 開発元 | Expo チーム | コミュニティ |
| ネイティブレイヤー | SwiftUI(iOS)、Jetpack Compose(Android) | 単一の MapView コンポーネント |
| iOS のプロバイダー | Apple Maps のみ | Apple Maps または Google Maps |
| iOS の最小要件 | Expo のドキュメントでは iOS 17。パッケージの README では iOS 18.0 と記載 | 本記事の対象外 |
| Expo Go | 開発ビルドを使用 | Expo のドキュメントによると Expo Go に同梱 |
| React コンポーネントのマーカー | 非対応(代わりに画像マーカーを使用) | 対応 |
| API の構成 | プラットフォームごとに2つのコンポーネント | 単一のコンポーネント |
リリース当初、expo-maps の発表記事ではこのライブラリをアルファ版と位置づけていました。記事には「SDK 53 で、expo-maps のアルファ版をリリースします」と書かれています。一方、SDK 58 のリファレンスページにはステータスの表記がありません。本番リリースの前に、expo-maps のリファレンスで最新のステータスを確認してください。もう一方の選択肢については、Expo の react-native-maps のページで解説されています。
expo-maps をインストールして開発ビルドを作成する
expo-maps を使うには、パッケージと、それを含むネイティブバイナリ(開発ビルド)の2つが必要です。SDK とバージョンが一致するよう、Expo CLI でパッケージをインストールします。
npx expo install expo-maps expo-location expo-dev-client
npx expo run:ios # or: npx expo run:android
expo-location は、本ガイドの後半でユーザーの座標を取得するために使います。expo-dev-client はバイナリを開発ビルドにするためのものです。expo-maps のドキュメントでは開発ビルドでの実行方法しか説明されていないため、開発ビルドを使用してください。EAS を使ってクラウドでビルドすることもできます。すぐに使えるプロジェクトが必要な場合は、npx create-expo-app --example with-maps を実行すると、expo-maps がインストール・設定済みの状態でプロジェクトを開始できます。
Android 用の Google Maps API キーを追加する
Apple Maps はキーなしで動作します。Android の Google Maps には、Maps SDK for Android を有効にした Google Cloud の API キーが必要です。このキーを app.json に追加したうえで、アプリを再ビルドします。
- Google Cloud プロジェクトを作成し、Maps SDK for Android を有効にします。
- API キーを作成し、パッケージ名と署名証明書の SHA-1 フィンガープリントを使って Android アプリに制限します。EAS ビルドの場合は、
eas credentialsでフィンガープリントを確認できます。 - キーと位置情報の権限用プラグインを app.json に追加します。
{
"expo": {
"android": {
"package": "com.example.places",
"config": {
"googleMaps": { "apiKey": "YOUR_ANDROID_MAPS_KEY" }
}
},
"plugins": [
[
"expo-maps",
{
"requestLocationPermission": true,
"locationPermission": "Allow $(PRODUCT_NAME) to show your position on the map"
}
]
]
}
}
npx expo run:androidで再ビルドします。JavaScript のリロードだけでは、ネイティブ設定の変更は反映されません。
プラグインのオプションのうち、requestLocationPermission は AndroidManifest.xml と Info.plist に権限を追加するブール値です。locationPermission は iOS 専用の使用目的メッセージを設定します。app.json では環境変数を読み込めません。キーをソース管理に含めたくない場合は、同じ android.config.googleMaps.apiKey のパスを app.config.js に移し、そこで process.env からキーを読み込むようにします。
両プラットフォームで地図を表示する
expo-maps にはクロスプラットフォームのコンポーネントがありません。そこで、Platform.OS に応じて AppleMaps.View または GoogleMaps.View を選択し、両方に同じ cameraPosition を渡す小さなラッパーを作成します。CameraPosition は coordinates と zoom を持つオブジェクトです。
import { Platform, Text } from 'react-native';
import { AppleMaps, GoogleMaps } from 'expo-maps';
const START = { coordinates: { latitude: 51.5074, longitude: -0.1278 }, zoom: 12 };
export function BasicMap() {
if (Platform.OS === 'ios') return <AppleMaps.View style={{ flex: 1 }} cameraPosition={START} />;
if (Platform.OS === 'android') return <GoogleMaps.View style={{ flex: 1 }} cameraPosition={START} />;
return <Text>Maps are only available on Android and iOS.</Text>;
}
最後の分岐は、どちらのコンポーネントも存在しない Web やその他のプラットフォームを処理します。
1つのデータ配列からマーカーを追加する
AppleMaps.View と GoogleMaps.View はどちらも markers 配列を受け取ります。また、どちらのマーカー型も id、title、coordinates を受け付けます。つまり、1つのマッピング関数で両プラットフォームにデータを渡せます。Apple の tintColor や Google の snippet のようなプラットフォーム固有のフィールドは、共通のマーカーにスプレッド構文で追加します。
type Place = { id: string; title: string; latitude: number; longitude: number };
export const PLACES: Place[] = [
{ id: 'office', title: 'Office', latitude: 51.5154, longitude: -0.141 },
{ id: 'cafe', title: 'Cafe', latitude: 51.5113, longitude: -0.1198 },
];
export const toMarker = (p: Place) => ({
id: p.id,
title: p.title,
coordinates: { latitude: p.latitude, longitude: p.longitude },
});
// iOS: markers={PLACES.map((p) => ({ ...toMarker(p), tintColor: '#e5484d' }))}
// Android: markers={PLACES.map((p) => ({ ...toMarker(p), snippet: 'Open now' }))}
expo-maps では React コンポーネントをマーカーとしてレンダリングできません。カスタムピンを使いたい場合は、expo-image の useImage で読み込んだ画像アイコンを利用できます。
ユーザーの現在地を表示し、中心に移動するには
expo-maps でユーザーの現在地を表示するには、3つのステップが必要です。位置情報の権限をリクエストし、権限が付与されたら現在地のドットを表示し、座標を取得したらカメラを移動します。ドットを表示するには、権限をビルド時に宣言したうえで、実行時にもリクエストしなければなりません。expo-maps の useLocationPermissions フックは、現在の権限ステータスと、権限をリクエストする関数を返します。
| タスク | AppleMaps.View | GoogleMaps.View |
|---|---|---|
| 現在地のドット | properties.isMyLocationEnabled | properties.isMyLocationEnabled と userLocation |
| ユーザーへの追従 | setCameraPosition を呼び出す | userLocation.followUserLocation |
| アニメーション時間 | 非対応 | duration(ミリ秒) |
ドットは、権限が付与された後にのみ有効にしてください。報告された Android の Issue によると、権限がない状態で isMyLocationEnabled を有効にすると、Android ではアプリがクラッシュしました。一方、iOS ではこの設定が無視されました。2026年11月4日に修正が Expo のメインブランチにマージされましたが、それ以前の expo-maps のリリースには含まれていません。権限の有無に応じてドットの表示を切り替える方法なら、どのバージョンでも動作します。また、この Issue では、Config Plugin の requestLocationPermission オプションはビルド時に権限を宣言するだけで、実行時には何もリクエストしないことも指摘されています。
expo-maps のドキュメントでは、cameraPosition prop は地図の初期カメラ位置と説明されています。そのため、state でこの値を変更する方法は、カメラを動かす手段としてドキュメント化されていません。代わりに、ref に対して setCameraPosition を呼び出します。iOS ではアニメーション時間の指定に対応していません。また、返される Promise はカメラの更新がスケジュールされた時点で解決され、アニメーションの完了時ではありません。
import { useEffect, useRef, useState, type ComponentRef } from 'react';
import { Platform, Text, View } from 'react-native';
import { AppleMaps, GoogleMaps, useLocationPermissions } from 'expo-maps';
import * as Location from 'expo-location';
import { PLACES, toMarker } from './places';
const START = { coordinates: { latitude: 51.5074, longitude: -0.1278 }, zoom: 12 };
type Coords = { latitude: number; longitude: number };
export function PlacesMap({ onSelect }: { onSelect: (id: string) => void }) {
const appleRef = useRef<ComponentRef<typeof AppleMaps.View>>(null);
const [permission, requestPermission] = useLocationPermissions();
const [me, setMe] = useState<Coords | null>(null);
const granted = !!permission?.granted;
useEffect(() => {
if (permission && !permission.granted && permission.canAskAgain) requestPermission();
}, [permission]);
useEffect(() => {
if (!granted) return;
Location.getCurrentPositionAsync().then(({ coords }) => {
const here = { latitude: coords.latitude, longitude: coords.longitude };
setMe(here);
appleRef.current?.setCameraPosition({ coordinates: here, zoom: 14 }); // iOS only; no duration
});
}, [granted]);
const handleMarker = (m: { id?: string }) => m.id && onSelect(m.id);
const denied = permission && !permission.granted && !permission.canAskAgain;
const map =
Platform.OS === 'ios' ? (
<AppleMaps.View
ref={appleRef}
style={{ flex: 1 }}
cameraPosition={START}
markers={PLACES.map((p) => ({ ...toMarker(p), tintColor: '#e5484d' }))}
properties={{ isMyLocationEnabled: granted }}
onMarkerClick={handleMarker} // iOS 18+
/>
) : Platform.OS === 'android' ? (
<GoogleMaps.View
style={{ flex: 1 }}
cameraPosition={START}
markers={PLACES.map(toMarker)}
properties={{ isMyLocationEnabled: granted }}
userLocation={me ? { coordinates: me, followUserLocation: true } : undefined}
onMarkerClick={handleMarker}
/>
) : (
<Text>Maps are only available on Android and iOS.</Text>
);
return (
<View style={{ flex: 1 }}>
{map}
{denied && <Text>Location is off. Enable it in Settings to see where you are.</Text>}
</View>
);
}
座標は Location.getCurrentPositionAsync から取得します。Android では followUserLocation によってカメラがユーザーに追従するため、このコードでは iOS の場合にのみ setCameraPosition を呼び出しています。権限が完全に拒否された場合、地図は START の位置のままで、操作を妨げないメッセージが地図の下に表示されます。
onMarkerClick でマーカーのタップに応答する
expo-maps でマーカーのタップを処理するには、AppleMaps.View または GoogleMaps.View に onMarkerClick を渡します。コールバックはタップされたマーカーを受け取るため、その id を読み取って、データ内の対応するレコードを見つけられます。Android では、サポート対象のすべてのバージョンで動作します。iOS については、Expo のドキュメントで iOS 18.0+ と明記されています。この制限は、ほかのタップ系コールバックや、selectMarker と selectAnnotation によるプログラムからの選択にも適用されます。
iOS 17 のデバイスでも地図は表示されますが、マーカーをタップしても JavaScript 側では何も起こりません。タップ操作に基づく UI が必須であれば、expo-build-properties で ios.deploymentTarget を 18.0 に設定してください。そうでない場合は、同じ選択状態を操作できるリストを地図の下に追加しましょう。こうすれば、iOS 17 のユーザーも各スポットにアクセスできます。
まとめ
expo-maps を使えば、一般的な地図画面をネイティブコンポーネントで実装できます。iOS では Apple Maps、Android では Google Maps を使い、共通のデータ配列と短い Platform.OS の分岐だけで済みます。次のステップとして、Android のキーを設定して再ビルドし、実機の iOS 17 デバイスと iOS 18 デバイスでテストしてください。タップや権限に関する違いは、こうしたテストで明らかになります。リリース後は、React Native 向けのセッションリプレイを活用すると、ログでは見えない問題を把握できます。たとえば、ユーザーがピンを探して地図をあちこちパンしている様子や、位置情報のプロンプトを閉じてしまう様子などです。こうしたセッションを確認することで、地図の操作フローが実際のユーザーにとって機能しているかどうかを判断できます。
よくある質問
開発環境では Google マップが表示されるのに、Play ストアのビルドでは空白のままになるのはなぜですか?
多くの場合、API キーが誤った SHA-1 フィンガープリントに制限されていることが原因です。Play アプリ署名を使用している場合、リリース版は Google によって再署名されます。そのため、インストールされたアプリにはアップロード鍵やデバッグ鍵ではなく、Google のアプリ署名証明書が付与されます。Play Console の[アプリの完全性]ページからアプリ署名鍵の SHA-1 をコピーし、キーの Android アプリの制限に追加してください。開発用のフィンガープリントも、引き続きキーに登録したままにしておきましょう。
expo-maps でルート、エリア、半径を示す円を描画できますか?
はい、可能です。AppleMaps.View と GoogleMaps.View はどちらも polylines、polygons、circles の props を受け付けます。各 prop は座標から構成される図形の配列を受け取り、円は中心点とメートル単位の半径を指定します。ただし、expo-maps は図形を描画するだけで、ルートの計算は行いません。車や徒歩のルートを表示するには、経路案内サービスからルートのジオメトリを取得し、デコードした座標を polyline として渡してください。
expo-maps を衛星写真の表示に切り替えるにはどうすればよいですか?
properties prop の中で mapType を設定します。AppleMaps.View では、AppleMapsMapType 列挙型の STANDARD、IMAGERY(衛星写真のみ)、HYBRID(衛星写真に道路とラベルを重ねたもの)のいずれかを使用します。GoogleMaps.View では、GoogleMapsMapType の NORMAL、SATELLITE、HYBRID、TERRAIN のいずれかを使用します。値の名前はプラットフォームによって異なります。そのため、共通のラッパーでは 'satellite' のような1つの設定を、iOS では IMAGERY、Android では SATELLITE に対応付ける必要があります。
expo-maps で付与された位置情報の権限は、expo-location にも適用されますか?
はい、適用されます。Android と iOS は、位置情報へのアクセス権を個々のライブラリではなく、アプリ全体に付与します。ユーザーが expo-maps の useLocationPermissions フックによるフォアグラウンドのプロンプトを許可すれば、expo-location からも同じ権限が参照されます。そのため、getCurrentPositionAsync は2回目のプロンプトなしで実行されます。ただし、バックグラウンドでの位置情報はどちらのプラットフォームでも別個の権限であり、expo-location を通じて個別にリクエストする必要があります。
Gain Debugging Superpowers
Unleash the power of session replay to reproduce bugs, track slowdowns and uncover frustrations in your app. Get complete visibility into your frontend with OpenReplay — the most advanced open-source session replay tool for developers.
Star on GitHub12k