Stille Harita Özelliklerini Gizleme

Platform seçin: Android iOS JavaScript

Haritadaki özelliklerin stilini değiştirmenin yanı sıra bunları tamamen gizleyebilirsiniz. Bu örnekte, haritanızda işletme önemli yerlerini (ÖY) ve toplu taşıma simgelerini nasıl gizleyeceğiniz gösterilmektedir.

Stil yalnızca kGMSTypeNormal harita türünde çalışır.

Haritanıza stil uygulama

Özel harita stillerini bir haritaya uygulamak için GMSMapStyle(...) çağrısı yaparak bir GMSMapStyle örneği oluşturun ve yerel bir JSON dosyası için URL veya stil tanımlarını içeren bir JSON dizesi iletin. GMSMapStyle örneğini haritanın mapStyle özelliğine atayın.

JSON dosyası kullanma

Aşağıdaki örneklerde, yerel bir dosya için URL'nin çağrılması GMSMapStyle(...) ve iletilmesi gösterilmektedir:

Aşağıdaki kod örneğinde, projenizde style.json adlı bir dosya olduğu varsayılmaktadır:

Swift

import GoogleMaps

class MapStyling: UIViewController {

  // Set the status bar style to complement night-mode.
  override var preferredStatusBarStyle: UIStatusBarStyle {
    return .lightContent
  }

  override func loadView() {
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 14.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)

    do {
      // Set the map style by passing the URL of the local file.
      if let styleURL = Bundle.main.url(forResource: "style", withExtension: "json") {
        mapView.mapStyle = try GMSMapStyle(contentsOfFileURL: styleURL)
      } else {
        NSLog("Unable to find style.json")
      }
    } catch {
      NSLog("One or more of the map styles failed to load. \(error)")
    }

    self.view = mapView
  }
}

Objective-C

#import "MapStyling.h"
@import GoogleMaps;

@interface MapStyling ()

@end

@implementation MapStyling

// Set the status bar style to complement night-mode.
- (UIStatusBarStyle)preferredStatusBarStyle {
  return UIStatusBarStyleLightContent;
}

- (void)loadView {
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.myLocationEnabled = YES;

  NSBundle *mainBundle = [NSBundle mainBundle];
  NSURL *styleUrl = [mainBundle URLForResource:@"style" withExtension:@"json"];
  NSError *error;

  // Set the map style by passing the URL for style.json.
  GMSMapStyle *style = [GMSMapStyle styleWithContentsOfFileURL:styleUrl error:&error];

  if (!style) {
    NSLog(@"The style definition could not be loaded: %@", error);
  }

  mapView.mapStyle = style;
  self.view = mapView;
}

@end

Stil seçeneklerini tanımlamak için projenize style.json adlı yeni bir dosya ekleyin ve aşağıdaki JSON stil bildirimini yapıştırarak işletme ilgi alanlarını (İA) ve toplu taşıma simgelerini gizleyin:

Dize kaynağı kullanma

Aşağıdaki örneklerde GMSMapStyle() çağrısı ve dize kaynağı iletme gösterilmektedir:

Swift

class MapStylingStringResource: UIViewController {

  let MapStyle = "JSON_STYLE_GOES_HERE"

  // Set the status bar style to complement night-mode.
  override var preferredStatusBarStyle: UIStatusBarStyle {
    return .lightContent
  }

  override func loadView() {
    let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 14.0)
    let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)

    do {
      // Set the map style by passing a valid JSON string.
      mapView.mapStyle = try GMSMapStyle(jsonString: MapStyle)
    } catch {
      NSLog("One or more of the map styles failed to load. \(error)")
    }

    self.view = mapView
  }
}

Objective-C

@implementation MapStylingStringResource

// Paste the JSON string to use.
static NSString *const kMapStyle = @"JSON_STYLE_GOES_HERE";

// Set the status bar style to complement night-mode.
- (UIStatusBarStyle)preferredStatusBarStyle {
  return UIStatusBarStyleLightContent;
}

- (void)loadView {
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:12];
  GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero camera:camera];
  mapView.myLocationEnabled = YES;

  NSError *error;

  // Set the map style by passing a valid JSON string.
  GMSMapStyle *style = [GMSMapStyle styleWithJSONString:kMapStyle error:&error];

  if (!style) {
    NSLog(@"The style definition could not be loaded: %@", error);
  }

  mapView.mapStyle = style;
  self.view = mapView;
}

@end

Aşağıdaki stil bildirimi, işletme önemli yerlerini (ÖY'ler) ve toplu taşıma simgelerini gizler. Aşağıdaki stil dizesini kMapStyle değişkeninin değeri olarak yapıştırın:

JSON stil bildirimleri

Stil verilmiş haritalar, renklendirme ve diğer stil değişikliklerini haritaya uygulamak için iki kavram kullanır:

  • Seçiciler, haritada stil uygulayabileceğiniz coğrafi bileşenleri belirtir. Yollar, parklar, su kütleleri ve daha fazlası ile bunların etiketleri bu kapsamda yer alır. Seçiciler, featureType ve elementType özellikleri olarak belirtilen özellikler ve öğeler içerir.
  • Stil oluşturucular, harita öğelerine uygulayabileceğiniz renk ve görünürlük özellikleridir. Bu değerler, renk tonu, renk ve parlaklık/gama değerlerinin birleşimiyle gösterilen rengi tanımlar.

JSON stil seçeneklerinin ayrıntılı açıklaması için stil referansına bakın.

Haritalar Platformu Stil Sihirbazı

Google Haritalar Platformu API'leri için özel stiller oluşturma

Maps Platform Stil Sihirbazı'nı kullanarak hızlı bir şekilde JSON stil nesnesi oluşturabilirsiniz. iOS için Haritalar SDK'sı, Maps JavaScript API ile aynı stil bildirimlerini destekler.

Tam kod örnekleri

GitHub'daki ApiDemos deposunda, stil kullanımını gösteren örnekler yer alır.