Zoom Levels

MapConductor utiliza niveles de zoom para controlar la escala y el nivel de detalle del mapa. El sistema de zoom sigue aproximadamente las convenciones de Google Maps, aunque puede variar ligeramente entre proveedores debido a diferencias en sus implementaciones internas.

Entender los niveles de zoom

Los niveles de zoom en MapConductor se representan como valores Double, normalmente en el rango de 0 a 21, donde:

Valores más altos = Más zoom (más detalle, área más pequeña).
Valores más bajos = Menos zoom (menos detalle, área más grande).
Valores fraccionarios = Interpolación suave entre niveles enteros.

// Examples of different zoom levels
val worldView = 2.0        // See continents
val countryView = 6.0      // See entire countries
val cityView = 10.0        // See cities
val streetView = 15.0      // See streets
val buildingView = 18.0    // See individual buildings

Referencia de niveles de zoom

Escala global (0–5)

// World and continent level
val worldLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(0.0, 0.0),
    zoom = 2.0  // Shows continents and oceans
)

val continentLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(39.8283, -98.5795), // USA center
    zoom = 4.0  // Shows entire continent
)

Escala de país / región (6–9)

// Country and state level
val countryLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(39.8283, -98.5795),
    zoom = 6.0  // Shows entire country
)

val stateLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(36.7783, -119.4179), // California center
    zoom = 8.0  // Shows state or large region
)

Escala de ciudad / barrio (10–15)

// City and metropolitan area level
val metropolitanLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194), // San Francisco
    zoom = 10.0  // Shows metropolitan area
)

val cityLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 12.0  // Shows city center and suburbs
)

// District and neighborhood level
val districtLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 13.0  // Shows districts
)

val neighborhoodLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 15.0  // Shows neighborhoods and major streets
)

Escala de edificio / detalle (16+)

// Street and block level
val streetLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 16.0  // Shows street layout
)

val detailedStreetLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 18.0  // Shows individual streets and small buildings
)

// Building and detail level
val buildingLevel = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 19.0  // Shows individual buildings
)

val maximumDetail = MapCameraPosition(
    position = GeoPoint.fromLatLong(37.7749, -122.4194),
    zoom = 21.0  // Maximum zoom level
)

Notas por proveedor

Los valores de zoom exactos y el rango máximo pueden variar según el SDK de mapas (Google Maps, Mapbox, etc.).
MapConductor normaliza en la medida de lo posible, pero siempre conviene probar en los proveedores que uses para ajustar los niveles a tus necesidades.

En general, usa el parámetro zoom de MapCameraPositionInterface como una guía relativa de escala, y ajusta los valores para que coincidan con la experiencia de usuario deseada en cada proveedor.