Harita Kutuları API'sı stili referansı

Standart reklam öğelerinin sunumunu özelleştirmek için stil seçeneklerini kullanabilirsiniz Google Haritalar. Yollar, görseller ve görseller gibi özelliklerin ve diğer önemli yerleri görüntüleyebilirsiniz. Proje yöneticisi olarak görünümündeyken, harita özelliklerini tamamen gizleyebilirsiniz. Bu da belirli harita bileşenlerini vurgulamak veya haritayı etrafındaki sayfanın stilini tamamlamalıdır.

Örnekler

Aşağıdaki JSON stil beyanı tüm harita özelliklerini griye dönüştürür, ardından ana yol geometrisini mavi renkte renklendirir ve yatay etiketleri gizler tamamen:

[
  {
    "featureType": "all",
    "stylers": [
      { "color": "#C0C0C0" }
    ]
  },{
    "featureType": "road.arterial",
    "elementType": "geometry",
    "stylers": [
      { "color": "#CCFFFF" }
    ]
  },{
    "featureType": "landscape",
    "elementType": "labels",
    "stylers": [
      { "visibility": "off" }
    ]
  }
]

JSON nesnesi

JSON stili bildirimi aşağıdaki öğelerden oluşur:

  • featureType (isteğe bağlı) - seçilecek özellikler tıklayın. Özellikler, Google’daki yollar, parklar, su kütleleri ve daha fazlasını içeren bir harita oluşturun. Belirli bir tüm özellikler seçilidir.
  • elementType (isteğe bağlı) - belirli bir özellik seçin. Öğeler, özelliğin alt bölümleridir. etiketleri ve geometrik özellikleri kullanır. Bir öğe belirtmezseniz bazı ek özellikler vardır.
  • stylers: Seçilen özellikler ve öğeler için geçerli olacak kurallar öğeler. Şekillendiriciler özelliğin rengini, görünürlüğünü ve ağırlığını belirtir. Bir özelliğe bir veya daha fazla stil belirleyici uygulayabilirsiniz.

Stil belirtmek için featureType ve stillerden oluşan bir kümeyi birleştirmeniz gerekir elementType seçicileri ve stylers öğenizi bir stile dönüştürün dizisidir. Tek bir dizide herhangi bir özellik kombinasyonunu hedefleyebilirsiniz. Ancak, Tek seferde uygulayabileceğiniz stil sayısı sınırlıdır. Stiliniz dizisi maksimum karakter sayısını aştığında hiçbir stil uygulanmaz.

Bu sayfanın geri kalanında özellikler, öğeler ve stil araçları.

featureType

Aşağıdaki JSON snippet'i haritadaki tüm yolları seçer:

{
  "featureType": "road"
}

Özellikler ya da özellik türleri, harita üzerindeki coğrafi özelliklerdir, yollar, parklar, su kütleleri, işletmeler ve daha fazlası dahil.

Özellikler, all ile bir kategori ağacı oluşturur deneyin. Bir özellik belirtmezseniz tüm özellikler seçilir. Bir all özelliğini belirtmek de aynı etkiyi yaratır.

Bazı özellikler, nokta kullanarak belirttiğiniz alt özellikler içerir çok önemlidir. Örneğin, landscape.natural veya road.local. Yalnızca şu gibi üst özelliği belirtirseniz: road, üst öğe için belirttiğiniz stiller şunun için geçerli olur: tüm alt öğeleri, örneğin road.local ve road.highway.

Üst özelliklerin dahil edilmeyen bazı öğeleri içerebileceğini unutmayın alt özelliklerinde belirlenebilir.

Aşağıdaki özellikler kullanılabilir:

  • all (varsayılan) tüm özellikleri seçer.
  • administrative tüm bağlı olduğu bölgeleri seçer. Stil yalnızca idari bölgelerin etiketlerini etkiler, coğrafi bölgeleri değil kenarlıklar veya dolgu.
    • administrative.country ülkeleri seçer.
    • administrative.land_parcel, arsaları seçer.
    • administrative.locality şehirleri seçer.
    • administrative.neighborhood mahalleleri seçer.
    • administrative.province illeri seçer.
  • landscape tüm manzaraları seçer.
    • landscape.man_made, binalar ve diğer kullanıcılar gibi insan yapımı özellikleri seçer birlikte çalışır.
    • landscape.natural, dağlar, nehirler ve piramitler gibi doğal özellikleri seçer. çöllere ve buzullara ev sahipliği yapıyor.
    • landscape.natural.landcover, arazi örtüsü özelliklerini (fiziksel malzeme) seçer. ormanlar, çayırlar, sulak alanlar ve çıplak arazi gibi dünyanın yüzeyini kaplayan geniş yelpaze.
    • landscape.natural.terrain, bir arazi yüzeyinin arazi özelliklerini seçer, gibi ayrıntılara yer verir.
  • poi tüm önemli yerleri seçer.
    • poi.attraction, turistik yerleri seçer.
    • poi.business, işletmeleri seçer.
    • poi.government, devlet binalarını seçer.
    • poi.medical, acil durum hizmetlerini seçer. Bu hizmetlere şunlar dahildir: hastaneler, eczaneler, polisler, doktorlar vb.
    • poi.park parkları seçiyor.
    • poi.place_of_worship, şunlar da dahil olmak üzere ibadet yerlerini seçer: kiliseler, tapınaklar, camiler ve diğerleri.
    • poi.school okulları seçer.
    • poi.sports_complex, spor komplekslerini seçiyor.
  • road tüm yolları seçer.
    • road.arterial ana yolları seçer.
    • road.highway otoyolları seçiyor.
    • road.highway.controlled_access şunu içeren otoyolları seçer: Kontrollü erişim.
    • road.local yerel yolları seçer.
  • transit, tüm toplu taşıma istasyonlarını ve hatları seçer.
    • transit.line toplu taşıma hatlarını seçiyor.
    • transit.station tüm toplu taşıma istasyonlarını seçer.
    • transit.station.airport havaalanlarını seçer.
    • transit.station.bus otobüs duraklarını seçiyor.
    • transit.station.rail tren istasyonlarını seçer.
  • water su kütlelerini seçer.

elementType

Aşağıdaki JSON snippet'i tüm yerel yollar için etiketleri seçer:

{
  "featureType": "road.local",
  "elementType": "labels"
}

Öğeler, özelliğin alt bölümleridir. Örneğin, bir yolda harita üzerindeki grafik çizgiden (Geometri) ve ayrıca (bir etiket) belirtin.

Aşağıdaki öğeler kullanılabilir, ancak belirli bir özelliğin öğelerin hiçbirini, bazılarını veya tümünü desteklemeyebilir:

  • all (varsayılan), belirtilen özelliğin tüm öğelerini seçer.
  • geometry, belirtilen tüm geometrik öğeleri seçer özelliğini kullanabilirsiniz.
    • geometry.fill yalnızca özelliğin dolgusunu seçer tıklayın.
    • geometry.stroke yalnızca özelliğin çizgisini seçer tıklayın.
  • labels, belirtilen özellik.
    • labels.icon yalnızca etiketi ekler.
    • labels.text yalnızca etiketin metnini seçer.
    • labels.text.fill yalnızca etiketin dolgusunu seçer. İlgili içeriği oluşturmak için kullanılan bir etiketin dolgusu genellikle farklı bir düzene sahip olan etiket metnini çevreler.
    • labels.text.stroke yalnızca etiketin çizgisini seçer metin.

stylers

Stiller, harita özelliklerine uygulayabileceğiniz biçimlendirme seçenekleridir. öğeler.

Aşağıdaki JSON snippet'i, bir RGB değeri:

"stylers": [
  { "color": "#99FF33" }
]

Bu snippet, ne olursa olsun bir özelliğin rengindeki tüm yoğunluğu o da başlangıç rengidir. Bunun sonucunda özellik gri tonlamalı olur:

"stylers": [
  { "saturation": -100 }
]

Bu snippet bir özelliği tamamen gizler:

    "stylers": [
      { "visibility": "off" }
    ]

Aşağıdaki stil seçenekleri desteklenir:

  • hue (RGB onaltılık biçimdeki bir dize) #RRGGBB), temel rengi gösterir.

    Not: Bu seçenek, doygunluğu ve açıklığı korurken tonu ayarlar (veya seçtiğiniz diğer stil seçeneklerinde) haritada tanımlayın). Elde edilen renk stiline göre değişir. temel harita. Google temel harita stilinde herhangi bir değişiklik yaparsa haritanızın hue ile stilize edilen özelliklerini etkileyecektir. Bu nedenle mümkünse mutlak color stil aracını kullanın.

  • lightness (-100 arasında bir kayan nokta değeri) ve 100), ışık akışının parlaklığındaki yüzde değişimini öğesine dokunun. Negatif değerler koyuluğu artırır (-100 değeri siyahı belirtir) pozitif değerler ise parlaklığı artırır (burada +100 değeri beyazı belirtir).

    Not: Bu seçenek, doygunluğu ve tonu korurken ışığı ayarlar (veya seçtiğiniz diğer stil seçeneklerinde) haritada tanımlayın). Elde edilen renk stiline göre değişir. temel harita. Google temel harita stilinde herhangi bir değişiklik yaparsa haritanızın lightness ile stilize edilen özelliklerini etkileyecektir. Daha iyi mutlak color biçimlendiriciyi kullanın.

  • saturation (-100 arasında bir kayan nokta değeri) ve 100), pikselin yoğunluğundaki yüzde değişimini temel rengi seçin.

    Not: Bu seçenek, doygunluğu ayarlarken tonu ve açıklığı korur (veya seçtiğiniz diğer stil seçeneklerinde) haritada tanımlayın). Elde edilen renk stiline göre değişir. temel harita. Google temel harita stilinde herhangi bir değişiklik yaparsa haritanızın saturation ile stilize edilen özelliklerini etkileyecektir. İnsanların mümkünse mutlak color stil aracını kullanmak daha iyidir.

  • gamma (0.01 ile arasında bir kayan nokta değeri 10.0 (burada 1.0 düzeltme uygulanmaz) gösterilir öğeye uygulanacak gama düzeltmesi miktarı. Gama düzeltmeleri renklerin parlaklığını doğrusal olmayan bir şekilde değiştirir, ancak değerleri için de geçerlidir. Gama düzeltmesi genellikle kontrastı ifade eder. Örneğin, gamayı Kontrastı artırmak veya azaltmak için öğeler.

    Not: Bu seçenek, varsayılan Google ayarına göre ışığı ayarlar stiline sahip olması gerekir. Google temel haritada herhangi bir değişiklik yaparsa değişiklikler, haritanızın Stil özellikleri Haritalar stilinde gamma Mutlak color kullanmak daha iyidir stil belirleyiciyi deneyin.

  • invert_lightness (true ise) mevcut ışığı tersine çevirir. Bu, örneğin hızlıca bir araya gelip beyaz metinli daha koyu bir haritaya geçmek.

    Not: Bu seçenek yalnızca varsayılan Google stilini tersine çevirir. Google temel harita stilinde herhangi bir değişiklik yaptığında, değişiklikler haritanızın invert_lightness ile stilize edilen özellikler. İnsanların mümkünse mutlak color stil aracını kullanmak daha iyidir.

  • visibility (on, off veya simplified), öğenin şurada görünüp görünmediğini ve nasıl görüneceğini belirtir: tıklayın. simplified görünürlüğü, bazı stil özelliklerini kaldırır veya yollar sadeleştirerek daha ince ana hatları olmayan çizgiler, parklar ise etiket metinlerini kaybeder ancak etiket simgesine dokunun.
  • color (RGB onaltılık biçimdeki bir dize) #RRGGBB) özelliğin rengini belirler.
  • weight (sıfırdan büyük veya sıfıra eşit bir tam sayı değeri) özelliğin ağırlığı (piksel cinsinden). Ağırlığın yüksek bir değere ayarlanması, bu da, karo kenarlıklarının yakınında kırpılmasına neden olur.

Stil kuralları belirttiğiniz sırayla uygulanır. Birleştirme aynı stilde işlem yapmasına olanak tanır. Bunun yerine işlemini stil dizisinde ayrı bir giriş olarak kaydeder.

Not: Bazı işlemler değişmeli olmadığından sıralama önemlidir. Özellikler ve/veya önceden stil işlemleri ile değiştirilmiş öğeler (genellikle) mevcut stilleri vardır. İşlemler, varsa bu mevcut stillere göre hareket eder.

Ton, doygunluk, açıklık modeli

Stilli haritalarda renk, Şekillendirici içinde rengi belirtmek için kullanılan doygunluk, hafiflik (HSL) modeli anlamına gelir. Ton, temel renk olan doygunluğu gösterir o rengin yoğunluğunu, açıklık ise bileşen rengindeki göreceli beyaz veya siyah miktarı.

Gama Düzeltme, genellikle renk alanının üzerindeki ışığı değiştirir kullanarak kontrastı artırabilir veya azaltabilirsiniz. Ek olarak, HSL modelinde hue değerinin yönü gösterdiği koordinat alanında renk çemberi içinde, doygunluk ve açıklık ise genlik değerlerini gösterir eksende ilerleyebilirsiniz. Tonlar, RGB renk alanında ölçülür ve renk tonları dışında RGB renk alanlarının çoğuna benzer, siyah renk yok.

Ton, doygunluk, açıklık modeli

hue, onaltılık HTML renk değerini alırken yalnızca bu değeri kullanır temel rengi (yani rengin etrafındaki yönünü) doygunluğunu ve ışığını değil, olarak ayrı ayrı gösterilir.

Örneğin, saf yeşilin tonunu hue:0x00ff00 veya hue:0x000100. Her iki ton da aynı olmalıdır. HSL renk modelinde her iki değer de saf yeşili gösterir.

RGB Renk Çarkı

Eşit kırmızı, yeşil ve mavi parçalarından oluşan RGB hue değerleri bir yön belirtmediğinden, bu değerlerin hiçbiri HSL koordinat alanını kullanır. Örnek: "#000000" (siyah), "#FFFFFF" (beyaz), ve saf grinin tonları gibi. Siyah, beyaz veya griyi belirtmek için tümünü kaldır saturation (değeri -100 olarak ayarlayın) ve bunun yerine lightness değerini ayarlayın.

Ayrıca, zaten bir rengi olan mevcut özelliklerde değişiklik yaparken şemada, hue gibi bir değerin değiştirilmesi mevcut değeri değiştirmez saturation veya lightness.