การฉายภาพและการซูม

01 · ค่าคงที่ของโลก

การฉายภาพ การคำนวณทางภูมิศาสตร์ และการคำนวณกระเบื้อง ล้วนอ้างอิงค่าคงที่ของ Earth

03 · การแปลงระหว่างการซูมและระดับความสูง

ผู้ให้บริการระบบกระเบื้อง 2D ใช้ระดับการซูม ส่วนระบบ 3D ใช้ระดับความสูงของกล้องหรือระยะการมองเห็นเพื่อแสดงสเกล MapConductor แปลงทั้งสองนี้ระหว่างกัน และแสดงให้แอปเห็นในสเกลการซูมเดียวกันเสมอ การแปลงถูกนำไปใช้สำหรับแต่ละผู้ให้บริการในรูปแบบคลาสหนึ่งที่สืบทอดจากคลาสนามธรรมทั่วไป

การแปลงรวมถึงละติจูดและความเอียง เนื่องจาก Web Mercator ขยายแผนที่มากขึ้นในละติจูดสูง ดังนั้นแม้ว่าจะซูมเท่ากัน ระดับความสูงของกล้องที่จำเป็นที่เส้นศูนย์สูตรและในละติจูดสูงจะแตกต่างกันหลายเท่า

abstract class AbstractZoomAltitudeConverter(
    protected val zoom0Altitude: Double,
) {
    abstract fun zoomLevelToAltitude(zoomLevel: Double, latitude: Double, tilt: Double): Double

    abstract fun altitudeToZoomLevel(altitude: Double, latitude: Double, tilt: Double): Double
}

public protocol ZoomAltitudeConverterProtocol {
    var zoom0Altitude: Double { get }

    func zoomLevelToAltitude(zoomLevel: Double, latitude: Double, tilt: Double) -> Double
    func altitudeToZoomLevel(altitude: Double, latitude: Double, tilt: Double) -> Double
}

export abstract class AbstractZoomAltitudeConverter {
    constructor(protected readonly zoom0Altitude: number =
        AbstractZoomAltitudeConverter.DEFAULT_ZOOM0_ALTITUDE) {}

    abstract zoomLevelToAltitude(params: { zoomLevel: number; latitude: number; tilt: number }): number;
    abstract altitudeToZoomLevel(params: { altitude: number; latitude: number; tilt: number }): number;
}

แต่ละแพ็กเกจของผู้ให้บริการมีตัวแปลง (`ZoomAltitudeConverter`) แอปไม่จำเป็นต้องเรียกโดยตรง แต่สามารถใช้ได้เมื่อสร้างการแสดงผล 3D ของคุณเอง

// The same camera position handed to both states
val shared = MapCameraPosition(
    position = GeoPoint.fromLatLong(35.6812, 139.7671),
    zoom = 14.0,
)
val maplibre = rememberMapLibreMapViewState(cameraPosition = shared)
val googlemaps = rememberGoogleMapViewState(cameraPosition = shared)

// Move one and the same value goes to the other
Row {
    MapLibreMapView(
        state = maplibre,
        modifier = Modifier.weight(1f),
        onCameraMoveEnd = { googlemaps.moveCameraTo(it) },
    )
    GoogleMapView(
        state = googlemaps,
        modifier = Modifier.weight(1f),
        onCameraMoveEnd = { maplibre.moveCameraTo(it) },
    )
}