Zoom Levels（ズームレベル）

MapConductor はズームレベルを使用して地図表示のスケールと詳細度を制御します。ズームレベルシステムはおおよそ Google Maps の規約に従いますが、基盤となる実装の違いにより地図SDK間で若干異なる場合があります。

ズームレベルの理解

MapConductor のズームレベルは Double 値として表され、通常 0 から 21 の範囲です:

高い数値 = よりズームイン（より詳細、より小さいエリア）
低い数値 = よりズームアウト（より少ない詳細、より大きいエリア）
小数値 = 整数レベル間のスムーズな補間

// 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

ズームレベルリファレンス

グローバルスケール (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
)

ユースケース:

グローバルデータの可視化
大陸の概要
フライトトラッキングアプリケーション
世界の天気図

地域スケール (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
)

ユースケース:

国の統計
州レベルのデータ
地域の天気
交通ネットワーク

メトロポリタンスケール (10-12)

// 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
)

ユースケース:

都市計画
公共交通機関
配達ゾーン
地区の境界

近隣スケール (13-15)

// 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
)

ユースケース:

地元のビジネスディレクトリ
学区
近隣サービス
不動産検索

ストリートスケール (16-18)

// 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
)

ユースケース:

ナビゲーションアプリケーション
住所検索
ストリートレベルサービス
徒歩案内

建物スケール (19-21)

// 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
)

ユースケース:

建物検査
資産管理
屋内マッピング
詳細な測量

地図SDKのバリエーション

MapConductor は地図SDK間でズームレベルを正規化しますが、微妙な違いがある可能性があります: