Clase 04 · Módulo 09
Mapas: elegir librería y mostrar datos
Mapas: elegir librería y mostrar datos
Qué logras en esta clase
Pones un mapa con tus propios datos en la app, sabiendo qué librería usar y qué te compromete cada una.
- Entiendes las tres piezas de todo mapa.
- Comparas las tres librerías con criterio.
- Configuras la clave sin dejarla expuesta.
- Muestras marcadores sin trabar la pantalla.
02
Las tres piezas de un mapa
- El motor: el componente que dibuja y responde a los gestos de mover y acercar.
- Las teselas: los trozos de imagen o de datos del mapa base (calles, nombres, relieve). Alguien los sirve desde internet.
- Tus datos: marcadores, líneas y zonas que tú pones encima.
La librería que elijas define el motor y, casi siempre, quién sirve las teselas.
03
Las tres opciones: quién pone el mapa
| Librería | Android | iOS |
|---|---|---|
react-native-maps | Google Maps | Apple Maps por defecto; Google opcional |
expo-maps | Google Maps | Apple Maps (no admite Google) |
| MapLibre React Native | El proveedor que elijas | El proveedor que elijas |
MapLibre es un motor de código abierto: no trae mapa base propio, tú conectas uno.
04
El mapa base no es tuyo
Alguien sirve las teselas y puede cobrar por ellas. Elegir librería es también elegir proveedor.
05
Las tres opciones: qué te piden
react-native-maps | expo-maps | MapLibre | |
|---|---|---|---|
| Clave | Google, restringida por plataforma | Google solo en Android | Ninguna de Google; estilo y teselas de un proveedor |
| Expo Go | Funciona | Requiere development build | Requiere development build |
| Requisito | Versión que fija el SDK | iOS 17 o superior | Nueva Arquitectura (v11 en adelante) |
06
Cómo elegir
| Si necesitas... | Elige |
|---|---|
| Un mapa estándar con marcadores, pronto | react-native-maps |
| Estilo visual propio o mapas sin conexión | MapLibre |
| Evitar la facturación de Google | MapLibre |
| La opción de Expo y aceptas iOS 17 o superior | expo-maps |
07
react-native-maps: ponerlo a andar
- Ejecuta
npx expo install react-native-maps. Ese comando instala la versión compatible con tu SDK. - Pruébalo: en Expo Go funciona sin configurar nada.
- Para tu propio build en Android, crea una clave de Google Maps y declárala en el config plugin.
- En iOS, con Apple Maps, no hace falta clave.
- Genera un nuevo development build.
08
El mapa en blanco del primer build
Si en tu build de Android aparece un mapa gris o en blanco:
- Falta la clave en la configuración, o
- La clave está restringida a otro paquete o a otra firma.
Pruébalo en un build propio antes de seguir construyendo sobre el mapa.
09
La clave de Google va dentro de la app
Esa clave viaja en el binario y cualquiera puede extraerla. Lo que la protege es la restricción, no el secreto.
10
Restringir la clave
- Crea una clave por plataforma.
- Restringe cada una a tu app: en Android, al nombre de paquete y a la huella de la firma.
- Limítala a los servicios de mapas que usas.
- Activa alertas de presupuesto en Google Cloud.
11
app.json no lee variables de entorno
Para no escribir la clave en un archivo que se sube a GitHub, cambia app.json por app.config.js, que sí puede leer process.env.
plugins: [
["react-native-maps", {
androidGoogleMapsApiKey: process.env.GOOGLE_MAPS_ANDROID_KEY,
}],
],El valor se guarda en las variables de entorno de EAS y en tu .env local, que nunca se sube (módulo 3).
12
Mostrar el mapa
<MapView style={{ flex: 1 }} initialRegion={region}>
<Marker
coordinate={{ latitude: -33.44, longitude: -70.65 }}
title="Cafetería Centro"
/>
</MapView>region tiene cuatro números: latitud y longitud del centro, y dos «deltas» que indican cuánto territorio se ve. Deltas pequeños muestran más cerca.
13
De la tabla al mapa
Tus puntos viven en Supabase, en una tabla con dos columnas numéricas. La consulta se hace con TanStack Query (módulo 6) y cada fila se convierte en un marcador.
14
No dibujes mil marcadores
Un mapa con cientos de marcadores se traba y no se entiende. Muestra solo lo que cabe en la pantalla.
15
Qué hacer con muchos puntos
| Técnica | Cómo funciona | Cuándo |
|---|---|---|
| Filtrar por zona visible | La consulta pide solo los puntos dentro del área del mapa | Siempre que pases de unas decenas |
| Agrupar | Puntos cercanos se muestran como un círculo con un número | Muchos puntos en poca superficie |
| Exigir acercarse | Los marcadores aparecen recién a cierto nivel de detalle | Datos repartidos por todo el país |
16
El punto azul del usuario
Mostrar la posición del usuario en el mapa exige el permiso de ubicación de la clase 3.
- Pídelo en contexto: al tocar «Centrar en mi ubicación», no al abrir el mapa.
- Si lo niegan, el mapa se centra en una ciudad por defecto y sigue siendo útil.
- No bloquees el mapa completo por un permiso que solo sirve para el punto azul.
17
expo-maps: cuándo sí
Usa los mapas nativos de cada sistema: Google en Android, Apple en iOS.
| A favor | En contra |
|---|---|
| La mantiene Expo | Pide iOS 17 o superior |
| No necesita clave en iOS | Algunos eventos de marcador requieren iOS 18 |
| No corre en Expo Go |
En Android la clave va en android.config.googleMaps.apiKey.
18
MapLibre: cuándo sí y qué asumes
Conviene cuando quieres un estilo propio, mapas sin conexión o no depender de Google.
Lo que asumes:
- Buscar un proveedor de estilo y teselas para producción, como MapTiler o Stadia Maps.
- Usar la Nueva Arquitectura: la versión 11 en adelante no funciona sin ella.
- Recompilar: no corre en Expo Go.
El paquete es @maplibre/maplibre-react-native.
19
Costos: revísalos antes de elegir
Los precios de Google Maps Platform y de los proveedores de teselas cambian y dependen del uso. Aquí no hay cifras: se comprueban en la fuente.
- Abre la página de precios del proveedor.
- Identifica qué se cobra: cargas de mapa, búsquedas, rutas.
- Estima tu uso mensual: usuarios activos por veces que abren el mapa.
- Compáralo con el tramo gratuito y configura una alerta de gasto.
20
La clave que termina en GitHub
Si ya pasó:
- Crea una clave nueva con sus restricciones.
- Reemplázala en las variables de entorno y genera un build.
- Elimina la clave antigua en la consola de Google.
Borrar el archivo no basta: la clave antigua sigue activa hasta que la eliminas.
21
¿De verdad necesitas un mapa?
| Con mapa | Sin mapa |
|---|---|
| El usuario explora una zona | El usuario solo quiere el más cercano |
| La posición relativa importa | Importa la distancia y el horario |
| Suma una librería, una clave y un costo | Una lista ordenada por distancia |
Una lista con el botón «Cómo llegar», que abre la app de mapas del teléfono, resuelve muchos casos sin nada de lo anterior.
22
Lo que te llevas
- Un mapa es motor, teselas y tus datos; la librería define las dos primeras.
react-native-mapspara empezar; MapLibre para estilo propio, sin conexión o sin Google;expo-mapssi aceptas iOS 17 o superior.- La clave de Google se protege restringiéndola y se carga desde
app.config.js. - Se dibuja solo lo visible.
- Los costos se revisan en la fuente antes de elegir.
23
Hazlo ahora
En 15 minutos:
- Instala
react-native-mapsy pídele a Claude Code una pantalla con el mapa centrado en tu ciudad. - Agrega tres marcadores escritos a mano; al tocar uno se ve su nombre.
- Abre la página de precios del proveedor que usarías en Android y anota qué acción se cobra.
- Decide si tu primera versión necesita mapa o le basta una lista.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026