MapConductorConfigurar MapTiler
Estos son los pasos para usar el SDK oficial de Android de MapTiler (com.maptiler:maptiler-sdk-kotlin) desde MapConductor. Puedes elegir estilos de referencia de MapTiler Cloud por nombre.
Antes de empezar
Obtener la clave de API
Emite una clave de API en el panel de MapTiler Cloud. Hay una cuota gratuita disponible.
Agregar dependencias
El SDK de MapTiler se puede obtener desde Maven Central.
dependencies {
// MapTiler Android SDK
implementation("com.maptiler:maptiler-sdk-kotlin:2.1.0")
// MapConductor BOM pins every module below
implementation(platform("com.mapconductor:mapconductor-bom:1.3.1"))
implementation("com.mapconductor:core")
implementation("com.mapconductor:for-maptiler")
}Pasar la clave de API
El módulo lee la clave desde los metadatos del manifiesto. Si usas Secrets Gradle Plugin, usa un marcador de posición. También se puede configurar directamente desde el código.
<manifest>
<uses-permission android:name="android.permission.INTERNET" />
<application>
<meta-data
android:name="MAPTILER_API_KEY"
android:value="${MAPTILER_API_KEY}" />
</application>
</manifest>// Alternative: set it in code before the first map is shown com.maptiler.maptilersdk.MTConfig.apiKey = "YOUR_MAPTILER_API_KEY"
VERIFICAR
Lo que deberías ver
Elige un estilo y muestra el mapa. Si se cargan los mosaicos, está listo.
@Composable
fun TestMapTiler(modifier: Modifier = Modifier) {
val mapState = rememberMapTilerMapViewState(
mapDesign = MapTilerDesign.Streets,
cameraPosition = MapCameraPosition(
position = GeoPoint(35.6812, 139.7671),
zoom = 11.0,
),
)
// If the map appears, the setup is correct.
MapTilerMapView(state = mapState, modifier = modifier)
}Diseños de mapa
MapTilerDesign enumera los estilos de referencia de MapTiler Cloud tal como están.
Solución de problemas
El mapa permanece completamente en blanco
- Verifica que MAPTILER_API_KEY en el manifiesto tenga el valor real.
- Verifica en el lado de MapTiler Cloud que la clave sea válida y no se haya excedido la cuota gratuita.
- Verifica que se haya otorgado el permiso INTERNET.
Error al compilar
- Verifica que las coordenadas y la versión del SDK del mapa coinciden con las especificaciones del catálogo de versiones.
- Verifica que la definición del repositorio esté en settings.gradle.kts (si repositoriesMode es FAIL_ON_PROJECT_REPOS, se ignorarán los repositorios del módulo).
- Si tienes varios SDK de mapas al mismo tiempo, verifica que no haya conflictos de dependencias con ./gradlew :app:dependencies.
Siguiente
Marker, Polyline, Polygon, Circle, GroundImage, RasterLayer, InfoBubble pueden usarse todos con la API común. Dado que el SDK de Android de MapTiler ejecuta MapLibre GL JS en un WebView, las formas se agregan al estilo como fuentes GeoJSON y capas fill/line. Dado que la interpolación geodésica y el manejo de agujeros utilizan la implementación central común, tendrán la misma forma que con otros proveedores.