Documentación / Configuración / iOS / Mappls

Configurar Mappls

Instrucciones para usar el SDK oficial de iOS de Mappls (MapmyIndia) con MapConductor. Instálalo con Swift Package Manager y autentícate mediante un archivo de configuración en la aplicación.

MODULE
MapConductorForMappls
API KEY
Requerido
VIEW
MapplsMapView
TIME
15 minutos
El mismo proveedor, otras plataformasAndroidReact

Antes de empezar

Xcode 15 o superior
Aplicación destinada a iOS 16.0 o superior
Cuenta y credenciales de Mappls (MapmyIndia)
STEP 01

Obtener credenciales

Registra la aplicación en la consola de desarrolladores de Mappls y obtén las credenciales. En iOS, la autenticación se realiza mediante archivos de configuración .i.conf / .i.olf. No se usa el método de pasar una sola clave de API.

STEP 02

Agregar paquete

Agrega el repositorio de distribución de Mappls y el módulo MapConductor mediante Swift Package Manager.

Package.swiftSwift
dependencies: [
    .package(url: "https://github.com/mappls-api/mappls-map-ios-distribution.git", from: "6.1.5"),
    .package(url: "https://github.com/MapConductor/ios-sdk-core", from: "1.3.1"),
    .package(url: "https://github.com/MapConductor/ios-for-mappls", from: "1.0.0"),
]
STEP 03

Colocar archivo de autenticación

Incluye los archivos .i.conf / .i.olf recibidos de Mappls en el bundle de la aplicación. MapConductor los carga antes de generar el mapa. No incluyas los archivos en el control de código fuente.

VERIFICAR

Lo que deberías ver

Muestra un mapa centrado en Delhi. Si los mosaicos se cargan, está listo.

import SwiftUI
import MapConductorCore
import MapConductorForMappls

struct TestMappls: View {
    @StateObject private var state = MapplsViewState(
        mapDesignType: MapplsDesign.Default,
        cameraPosition: MapCameraPosition(
            position: GeoPoint(latitude: 28.6139, longitude: 77.2090),
            zoom: 11
        )
    )

    var body: some View {
        MapplsMapView(state: state)
    }
}

Diseños de mapa

Notes
Default
Estilo predeterminado utilizable independientemente del contrato
StandardDay
Estilo diurno estándar
StandardNight / GreyDay
Opción de pago con costo adicional. Si no hay contrato, el SDK lo rechaza.

Solución de problemas

El mapa está completamente en blanco y no se carga ningún mosaico

  • Verifica que las credenciales estén configuradas antes de generar el mapa.
  • Verifica en la consola de Mappls si la clave es válida y si no se ha excedido el límite de uso.
  • Verifica si el dispositivo puede conectarse a la red.

Al cambiar el estilo, aparece "style not found"

  • StandardNight y GreyDay son opciones de pago con costo adicional. Si no tienes contrato, usa Default o StandardDay.

No se muestran mosaicos de URLs que no sean de Mappls, como capas ráster

  • La capa HTTP nativa de Mappls descarta o trunca las solicitudes que no contienen mappls / mapmyindia en la URL. MapConductor ya evita esto, pero si has reemplazado tu propio módulo HTTP del SDK, la evitación también se desactiva.

Siguiente

Los marcadores, polilíneas, polígonos, círculos, imágenes de suelo, capas ráster e InfoBubble se pueden seguir utilizando a través de la API común.