Harita yapılandırma

Platform seçin: Android iOS

Bu genel bakışta, iOS için Haritalar SDK'sı kullanılarak iOS uygulamasına eklenen bir haritanın nasıl yapılandırılacağı açıklanmaktadır.

Genel Bakış

Uygulamanıza harita ekledikten sonra haritanın ilk seçeneklerini ve çalışma zamanı ayarlarını yapılandırabilirsiniz. Harita kapsayıcısı ekleme hakkında ayrıntılı bilgi için Harita ekleme başlıklı makaleyi inceleyin.

İlk harita ayarları şunları içerir:

• Konum, yakınlaştırma, yön ve eğim dahil olmak üzere kamera konumu. Kamera konumlandırmayla ilgili ayrıntılar için Kamera ve Görünüm bölümüne bakın.
• Haritanın arka plan rengi.
• Harita türü.
• Yakınlaştırma düğmeleri ve pusula gibi gösterilecek kullanıcı arayüzü bileşenleri.
• Etkinleştirilecek hareketler.

Çalışma zamanında, GMSMapView nesnesini güncelleyerek bu ayarları ve bazı ek ayarları yapılandırabilirsiniz.

Harita seçenekleri

Harita görünümünüzü başlatırken yapılandırma seçenekleri GMSMapViewOptions ile ayarlanır. Seçenek özellikleri arasında frame, camera, mapID veya backgroundColor bulunur.

Harita Seçenekleri
çerçeve	Değer: CGRect Harita çerçevesi. Varsayılan olarak CGRectZero değerine ayarlanır.
kamera	Değer: GMSCameraPosition Varsayılan harita kamerası konumu.
mapID	Değer: GMSMapID Google harita kimliği. İsteğe bağlı parametre.
backgroundColor	Değer: UIColor Varsayılan olarak UIColor.lightGray değerine ayarlanır.

Harita seçeneklerini yapılandırma

Kendi seçenek özelliklerinizi ayarlayabilir veya varsayılan değerlerle örneklendirilmiş bir GMSMapViewOptions nesnesini doğrudan GMSMapView yöntemine iletebilirsiniz.

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                        longitude:151.2086
                                                             zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Varsayılan değerlere sahip bir GMSMapViewOptions nesnesini doğrudan GMSMapView yöntemine iletme örneğini aşağıda bulabilirsiniz.

Swift

let options = GMSMapViewOptions()
let mapView = GMSMapView(options:options) //initialized with default values

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options]; //initialized with default values

Arka plan rengini yapılandırma

Koyu modda çalışırken veya harita görünümleri arasında geçiş yaparken varsayılan harita arka plan rengini geçersiz kılmak faydalı olabilir. Bunu yapmak için harita seçenekleri backgroundColor özelliğini ayarlayabilirsiniz.

Swift

let options = GMSMapViewOptions()
options.backgroundColor = UIColor.yellowColor
let mapView = GMSMapView(options:options)

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.backgroundColor = UIColor.yellowColor;
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];

Not: Arka plan rengini yapılandırmak için bulut tabanlı harita stillerini de kullanabilirsiniz. Harita stilinde ayarlanan arka plan rengi, yerel arka plan renginden daha yüksek önceliğe sahiptir. Daha fazla bilgi için bulut tabanlı harita stilleri için Uygulama arka plan rengini değiştirme başlıklı makaleyi inceleyin.

Harita türleri

Haritanızı çeşitli harita türlerinden biriyle özelleştirebilirsiniz. Haritanın türü, haritanın genel görünümünü belirler. Örneğin, bir atlas genellikle sınırları göstermeye odaklanan siyasi haritalar ve bir şehir veya bölgedeki tüm yolları gösteren yol haritaları içerir. iOS için Haritalar SDK'sı aşağıdaki harita türlerini sunar:

Harita Türü
Normal	Değer: kGMSTypeNormal Tipik yol haritası. Yolları, insanlar tarafından inşa edilen bazı özellikleri ve nehirler gibi önemli doğal özellikleri gösterir. Yol ve özellik etiketleri de görünür. Harita renk şemasını koyu, açık veya sistem ayarlarını takip edecek şekilde ayarlamayı destekler.
Karma	Değer: kGMSTypeHybrid Yol haritaları eklenmiş uydu fotoğrafı verileri. Yol ve özellik etiketleri de görünür.
Uydu	Değer: kGMSTypeSatellite Uydu fotoğrafı verileri. Yol ve özellik etiketleri görünmez.
Arazi	Değer: kGMSTypeTerrain Topoğrafik veriler. Haritada renkler, eş yükselti eğrileri, etiketler ve perspektif gölgelendirme bulunur. Bazı yollar ve etiketler de görünür. Harita renk şemasını koyu, açık veya sistem ayarlarını takip edecek şekilde ayarlamayı destekler.
Yok	Değer: kGMSTypeNone Harita karosu yok. Temel harita karoları oluşturulmaz. Bu mod, karolu katmanlarla birlikte kullanıldığında faydalıdır. Harita türü "none" olarak ayarlandığında trafik verilerinin gösterilmesi devre dışı bırakılır.

Harita türünü değiştirme

Bir haritanın türünü ayarlamak için GMSMapView.mapType özelliğine yeni bir değer atayın. Örneğin, uydu haritası türünü görüntülemek için:

Swift

let options = GMSMapViewOptions()
options.camera = GMSCameraPosition.camera(withLatitude: -33.8683, longitude: 151.2086, zoom: 6)
let mapView = GMSMapView(options:options)
mapView.mapType = .satellite

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
options.camera = [GMSCameraPosition cameraWithLatitude:-33.8683
                                                  longitude:151.2086
                                                        zoom:6];
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
mapView.mapType = kGMSTypeSatellite;

Aşağıdaki seçici, aynı konum için arazi, normal ve karma haritaların karşılaştırmasını gösterir:

İç Mekan Haritaları

iOS için Haritalar SDK'sı, yüksek yakınlaştırma seviyelerinde havaalanları, alışveriş merkezleri, büyük perakende mağazaları ve toplu taşıma istasyonları gibi kapalı alanların kat planlarını gösterir. Bina içi kat planları, "normal" harita türü (kGMSTypeNormal) için varsayılan harita parçalarına entegre edilir ve kullanıcı yakınlaştırdığında otomatik olarak etkinleştirilir, harita uzaklaştırıldığında ise kaybolur.

GMSMapView öğesinin indoorEnabled özelliğini NO olarak ayarlayarak iç mekan haritalarını devre dışı bırakabilirsiniz.

Swift

mapView.isIndoorEnabled = false
      

Objective-C

mapView.indoorEnabled = NO;
      

Alternatif olarak, yalnızca Kat Seçici kontrolünü devre dışı bırakabilirsiniz.

Kat planı ekleme

Kat planları belirli konumlarda kullanılabilir. Uygulamanızda vurgulamak istediğiniz bir binanın kat planı verileri mevcut değilse şunları yapabilirsiniz:

• Google Haritalar'a doğrudan kat planları ekleyin. Bu sayede planlarınız tüm Google Haritalar kullanıcıları tarafından kullanılabilir.
• Kat planını yer yer paylaşımı olarak görüntüleme Bu sayede, kat planlarınızı yalnızca uygulamanızın kullanıcıları görüntüleyebilir.

Trafik katmanı

Kullanıcılarınıza, haritayı trafik yoğunluğu bilgileriyle birlikte görüntüleme olanağı sunabilirsiniz. Bu sayede, yerel trafik durumlarının görsel bir özetini görebilirler. trafficEnabled yöntemini çağırarak trafik katmanını açıp kapatabilirsiniz. Aşağıdaki örnekte, trafik katmanının haritada nasıl görünebileceği gösterilmektedir.

Toplu taşıma katmanı

iOS için Haritalar SDK'sı, transitEnabled yöntemini kullanarak bir şehrin toplu taşıma ağını haritanızda göstermenize olanak tanır. Trafik katmanı etkinleştirildiğinde ve harita, toplu taşıma bilgilerini destekleyen bir şehre ortalandığında harita, ana toplu taşıma hatlarını kalın, renkli çizgiler olarak gösterir. Hattın rengi, toplu taşıma hattı operatöründen alınan bilgilere göre belirlenir. Toplu taşıma katmanını etkinleştirdiğinizde, toplu taşıma rotalarını daha iyi vurgulamak için temel haritanın stili değişir.

Şehrinizdeki toplu taşımayı denetleyen bir kamu kurumuysanız ve verilerinizin dahil edilmesini istiyorsanız daha fazla bilgi edinmek için Google Transit İş Ortağı Programı sitesini ziyaret edin.

Aşağıdaki örnekte, toplu taşıma katmanının haritada nasıl görünebileceği gösterilmektedir.

Erişilebilirlik

Varsayılan olarak, haritadaki erişilebilirlik öğeleri gizlidir. GMSMapView öğesinin accessibilityElementsHidden özelliğini NO olarak ayarlayarak erişilebilirliği etkinleştirebilirsiniz. Bu, yer paylaşımı nesneleri (ör. GMSMarker ve bilgi pencereleri, GMSPolyline vb.) için erişilebilirlik öğelerinin oluşturulmasına neden olur.

Swift

mapView.accessibilityElementsHidden = false
      

Objective-C

mapView.accessibilityElementsHidden = NO;
      

Bu özellik, iOS için Haritalar SDK'sındaki varsayılan değerin YES olması dışında, resmi olmayan UIAccessibility protokolüne uygundur.

Konumum

Varsayılan olarak haritada konum verisi gösterilmez. GMSMapView üzerinde myLocationEnabled ayarını yaparak mavi "Konumum" noktasını ve pusula yönünü etkinleştirebilirsiniz.

Swift

mapView.isMyLocationEnabled = true
      

Objective-C

mapView.myLocationEnabled = YES;
      

Bu özellik etkinleştirildiğinde kullanıcının mevcut konumu myLocation özelliği aracılığıyla sağlanır. Bu özellik hemen kullanılamayabilir. Örneğin, iOS kullanıcıdan bu verilere erişim izni vermesini isterse. Bu durumda nil.

Swift

print("User's location: \(String(describing: mapView.myLocation))")
      

Objective-C

NSLog(@"User's location: %@", mapView.myLocation);
      

3D binalar

Birçok şehir yakından görüntülendiğinde, aşağıdaki Seattle, Washington resminde görüldüğü gibi 3D binalar görünür olur.

Swift veya Objective-C'de ilgili GMSMapView özelliğini ayarlayarak 3D binaları devre dışı bırakabilirsiniz:

Swift

mapView.isBuildingsEnabled = false
      

Objective-C

[mapView setBuildingsEnabled:NO];
      

Harita alan ayarlaması

Google Haritalar, GMSMapView tarafından tanımlanan bölgenin tamamını dolduracak şekilde tasarlanmıştır. Haritanın görünümü ve davranışıyla ilgili çeşitli özellikler, görünümün boyutlarına göre belirlenir:

• Kameranın hedefi, dolgulu bölgenin merkezini yansıtır.
• Harita kontrolleri, haritanın kenarlarına göre konumlandırılır.
• Telif hakkı beyanları veya Google logosu gibi yasal bilgiler haritanın alt kenarında görünür.

GMSMapView kullanarak haritanın kenarlarına dolgu ekleyebilirsiniz.padding özelliği. Harita, kapsayıcının tamamını doldurmaya devam eder ancak metin ve kontrol konumlandırma, harita hareketleri ve kamera hareketleri daha küçük bir alana yerleştirilmiş gibi davranır. Bu durumda aşağıdaki değişiklikler yapılır:

• API çağrıları veya düğme basışları (ör. pusula, konumum) kullanılarak yapılan kamera hareketleri, dolgulu bölgeye göredir.
• GMSMapView.projection, yalnızca dolgulu bölgeyi içeren bir projeksiyon döndürür.
• Kullanıcı arayüzü kontrolleri, kapsayıcının kenarından belirtilen nokta sayısı kadar kaydırılır.

Dolgu, haritanın bir kısmıyla çakışan kullanıcı arayüzleri tasarlarken yararlı olabilir. Örneğin, resimde haritanın üst ve sağ kenarları boyunca dolgu uygulanmıştır. Görünür harita kontrolleri ve yasal metin, dolgulu bölgenin (yeşil renkle gösterilir) kenarları boyunca gösterilirken harita, kapsayıcının tamamını (mavi renkle gösterilir) doldurmaya devam eder. Bu örnekte, harita kontrollerini gizlemeden haritanın sağ tarafında bir menü gösterebilirsiniz.

Haritanıza dolgu eklemek için bir UIEdgeInsets nesnesi oluşturun ve bunu GMSMapView öğesine iletin.padding mülk.

Swift

// Insets are specified in this order: top, left, bottom, right
let mapInsets = UIEdgeInsets(top: 100.0, left: 0.0, bottom: 0.0, right: 300.0)
mapView.padding = mapInsets
      

Objective-C

// Insets are specified in this order: top, left, bottom, right
UIEdgeInsets mapInsets = UIEdgeInsetsMake(100.0, 0.0, 0.0, 300.0);
mapView.padding = mapInsets;
      

Not: Google Haritalar Platformu Hizmet Şartları'nda belirtildiği gibi, uygulamanız Google logosunu veya telif hakkı bildirimlerini kaldırmamalı ya da gizlememelidir. Harita alan ayarlaması, gerekirse bu öğeleri yeniden konumlandırmanıza olanak tanır. Haritanın alt kısmında özel bir kullanıcı arayüzü gösteriyorsanız logonun ve yasal uyarıların görünür olması için haritanın alt kısmına dolgu ekleyin.

Harita renk şeması

Normal ve arazi türündeki haritalarda, harita renk şemasını koyu, açık veya mevcut sistem ayarlarını kullanacak şekilde ayarlayabilirsiniz. Örneğin, günün saatine veya cihazın iç ya da dış mekanda kullanımına göre harita renk şemasını koyulaştırabilir veya açabilirsiniz.

Harita renk şemasını ayarlamak ve güncellemek için GMSMapView overrideUserInterfaceStyle: kullanın.

Swift

let options = GMSMapViewOptions()
// Map is init to use light mode by default.
let mapView = GMSMapView(options: options)
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = .dark
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = .light
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = .unspecified

Objective-C

GMSMapViewOptions *options = [[GMSMapViewOptions alloc] init];
// Map is init to always use light mode.
GMSMapView *mapView = [[GMSMapView alloc] initWithOptions:options];
// Set map to use dark mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleDark;
// Set map to use light mode.
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleLight;
// Set map to use dark/light mode based on the value of traitCollection.userInterfaceStyle
mapView.overrideUserInterfaceStyle = UIUserInterfaceStyleUnspecified;

Haritalarınız için özel açık ve koyu stiller oluşturmak istiyorsanız bulut tabanlı harita stillerini kullanın.