Тепловые карты

На этой странице описывается утилита для построения тепловых карт, доступная в библиотеке утилит Maps SDK для iOS . Тепловые карты полезны для представления распределения и плотности точек данных на карте.

В этом видео обсуждается использование тепловых карт в качестве альтернативы маркерам, когда ваши данные требуют большого количества точек данных на карте.

Тепловые карты позволяют пользователям легко оценить распределение и относительную интенсивность точек данных на карте. Вместо размещения маркера в каждой точке тепловые карты используют цвет для представления распределения данных.

В примере ниже красным цветом обозначены районы с высокой концентрацией полицейских участков в Виктории, Австралия.

Если вы еще не настроили библиотеку, следуйте руководству по настройке, прежде чем читать остальную часть этой страницы.

Добавление простой тепловой карты

Чтобы добавить тепловую карту на карту, вам понадобится набор данных, содержащий координаты каждого интересующего вас места. Сначала создайте экземпляр GMUHeatmapTileLayer , установив свойство map на GMSMapView . Сделайте это в функции viewDidLoad() вашего приложения, чтобы обеспечить загрузку базовой карты перед началом работы с тепловой картой. Затем передайте коллекцию объектов GMUWeightedLatLng экземпляру GMUHeatmapTileLayer .

Утилита предоставляет класс GMUHeatmapTileLayer , который принимает коллекцию объектов GMUWeightedLatLng . Он создаёт изображения тайлов для различных уровней масштабирования на основе заданных параметров радиуса, градиента и непрозрачности.

Рассмотрим шаги более подробно:

1. Создайте экземпляр GMUHeatmapTileLayer , установив свойство map на GMSMapView (сделайте это в функции viewDidLoad() вашего приложения).
2. Передайте коллекцию объектов GMUWeightedLatLng экземпляру GMUHeatmapTileLayer .
3. Вызовите GMUHeatmapTileLayer.map , передав вид карты.

   Быстрый

   class Heatmap: UIViewController {
   
     private var mapView: GMSMapView!
     private var heatmapLayer: GMUHeatmapTileLayer!
   
     override func viewDidLoad() {
       super.viewDidLoad()
       heatmapLayer = GMUHeatmapTileLayer()
       heatmapLayer.map = mapView
     }
   
     // ...
   
     func addHeatmap() {
   
       // Get the data: latitude/longitude positions of police stations.
       guard let path = Bundle.main.url(forResource: "police_stations", withExtension: "json") else {
         return
       }
       guard let data = try? Data(contentsOf: path) else {
         return
       }
       guard let json = try? JSONSerialization.jsonObject(with: data, options: []) else {
         return
       }
       guard let object = json as? [[String: Any]] else {
         print("Could not read the JSON.")
         return
       }
   
       var list = [GMUWeightedLatLng]()
       for item in object {
         let lat = item["lat"] as! CLLocationDegrees
         let lng = item["lng"] as! CLLocationDegrees
         let coords = GMUWeightedLatLng(
           coordinate: CLLocationCoordinate2DMake(lat, lng),
           intensity: 1.0
         )
         list.append(coords)
       }
   
       // Add the latlngs to the heatmap layer.
       heatmapLayer.weightedData = list
     }
   }
         

   Objective-C

   @implementation Heatmap {
     GMSMapView *_mapView;
     GMUHeatmapTileLayer *_heatmapLayer;
   }
   
   - (void)viewDidLoad {
     [super viewDidLoad];
     _heatmapLayer = [[GMUHeatmapTileLayer alloc] init];
     _heatmapLayer.map = _mapView;
   }
   
   // ...
   
   - (void) addHeatmap {
   
     // Get the data: latitude/longitude positions of police stations.
     NSURL *path = [NSBundle.mainBundle URLForResource:@"police_stations" withExtension:@"json"];
     NSData *data = [NSData dataWithContentsOfURL:path];
     NSArray *json = [NSJSONSerialization JSONObjectWithData:data options:0 error:nil];
   
     NSMutableArray<GMUWeightedLatLng *> *list = [[NSMutableArray alloc] init];
     [json enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
       NSDictionary *item = (NSDictionary *)obj;
       CLLocationDegrees lat = [(NSNumber *) [item valueForKey:@"lat"] doubleValue];
       CLLocationDegrees lng = [(NSNumber *) [item valueForKey:@"lng"] doubleValue];
       GMUWeightedLatLng *coords = [[GMUWeightedLatLng alloc] initWithCoordinate:CLLocationCoordinate2DMake(lat, lng)
                                                                       intensity:1.0];
       [list addObject:coords];
     }];
   
   
     // Add the latlngs to the heatmap layer.
     _heatmapLayer.weightedData = list;
   }
   @end
         

В этом примере данные хранятся в JSON-файле police_stations.json . Вот фрагмент файла:

[
{"lat" : -37.1886, "lng" : 145.708 } ,
{"lat" : -37.8361, "lng" : 144.845 } ,
{"lat" : -38.4034, "lng" : 144.192 } ,
{"lat" : -38.7597, "lng" : 143.67 } ,
{"lat" : -36.9672, "lng" : 141.083 }
]

Настройка тепловой карты

Тепловая карта имеет несколько настраиваемых свойств. Вы можете задать параметры при первоначальном создании экземпляра GMUHeatmapTileLayer или в любой момент, указав новое значение параметра.

Доступны следующие варианты:

1. Радиус: размер гауссовского размытия, применяемого к тепловой карте, выраженный в пикселях. Значение по умолчанию — 20. Должно быть в диапазоне от 10 до 50. Для установки радиуса используйте GMUHeatmapTileLayer.radius .

2. Градиент: диапазон цветов, который тепловая карта использует для создания своей цветовой карты, от самой низкой до самой высокой интенсивности. GMUGradient создаётся с помощью целочисленного массива, содержащего цвета, и массива с плавающей точкой, указывающего начальную точку для каждого цвета, заданную в процентах от максимальной интенсивности и выраженную в виде дроби от 0 до 1. Для одноцветного градиента необходимо указать только один цвет или минимум два цвета для многоцветного градиента. Цветовая карта генерируется путём интерполяции между этими цветами. Градиент по умолчанию состоит из двух цветов. Параметр colorMapSize определяет количество шагов градиента. Большие числа приведут к более плавному градиенту, а меньшие — к более резким переходам, похожим на контурный график. Используйте GMUHeatmapTileLayer.gradient для настройки градиента.

3. Непрозрачность: это непрозрачность всего слоя тепловой карты, которая может изменяться от 0 до 1. Значение по умолчанию — 0,7. Используйте GMUHeatmapTileLayer.opacity для установки значения непрозрачности.

Например, создайте Gradient :

let gradientColors: [UIColor] = [.green, .red]
let gradientStartPoints: [NSNumber] = [0.2, 1.0]
heatmapLayer.gradient = GMUGradient(
  colors: gradientColors,
  startPoints: gradientStartPoints,
  colorMapSize: 256
)
      

NSArray<UIColor *> *gradientColors = @[UIColor.greenColor, UIColor.redColor];
NSArray<NSNumber *> *gradientStartPoints = @[@0.2, @1.0];
_heatmapLayer.gradient = [[GMUGradient alloc] initWithColors:gradientColors
                                                 startPoints:gradientStartPoints
                                                colorMapSize:256];
      

Чтобы изменить непрозрачность существующей тепловой карты:

heatmapLayer.opacity = 0.7
      

_heatmapLayer.opacity = 0.7;
      

Обновить существующую опцию

Чтобы обновить уже установленную опцию, выполните следующие действия:

1. Обновите параметр до желаемого значения.
2. Вызовите GMUHeatmapTileLayer.clearTileCache() .

Изменение набора данных

Чтобы изменить набор данных, на основе которого строится тепловая карта:

1. Обновите коллекцию данных. Используйте GMUHeatmapTileLayer.weightedData , передав массив GMUWeightedLatLng .
2. Вызовите GMUHeatmapTileLayer.clearTileCache() .

Удаление тепловой карты

Чтобы удалить тепловую карту, вызовите GMUHeatmapTileLayer.map , передав nil .

heatmapLayer.map = nil
      

_heatmapLayer.map = nil;
      

Посмотреть демо-версию приложения

Другой пример реализации тепловой карты — HeatmapViewController в демонстрационном приложении, которое входит в состав библиотеки утилит. В руководстве по настройке показано, как запустить демонстрационное приложение.