Duyuru: Yakında Google Haritalar Platformu'nda yeni temel harita stili kullanıma sunulacak. Harita stilinde yapılan bu güncelleme; yeni bir varsayılan renk paleti, modernleştirilmiş raptiyeler, harita deneyimleri ve kullanılabilirlik ile ilgili iyileştirmeler içerir. Tüm harita stilleri Mart 2025'te otomatik olarak güncellenecektir. Kullanılabilirlik ve özelliği daha erken etkinleştirme hakkında daha fazla bilgi için Google Haritalar Platformu için yeni harita stili başlıklı makaleyi inceleyin.

Bu sayfa, Cloud Translation API ile çevrilmiştir.

Maps JavaScript API için Stil Referansı

Platform seçin: Android iOS JavaScript

Stil seçenekleri sayesinde standart Google harita stillerinin sunumunu özelleştirebilir, yollar, parklar, işletmeler ve diğer önemli yerler gibi özelliklerin görsel görüntüsünü değiştirebilirsiniz. Bu özelliklerin stilini değiştirmenin yanı sıra özellikleri tamamen gizleyebilirsiniz. Bu sayede, haritanın belirli bileşenlerini vurgulayabilir veya haritanın etrafındaki sayfanın tarzını tamamlamasını sağlayabilirsiniz.

Örnekler

Aşağıdaki JSON stil beyanı, tüm harita özelliklerini gri yapar, ana yol geometrisini mavi renkte gösterir ve yatay etiketleri tamamen gizler:

[
  {
    "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ı): Bu stil değişikliği için seçilecek özellikler. Özellikler, haritadaki coğrafi niteliklerdir. Bu özellikler arasında yollar, parklar, su kütleleri ve daha fazlası yer alır. Bir özellik belirtmezseniz tüm özellikler seçilir.
elementType (isteğe bağlı): Seçilecek belirtilen özelliğin mülkü. Öğeler, etiketler ve geometri de dahil olmak üzere, bir özelliğin alt bölümleridir. Bir öğe belirtmezseniz özelliğin tüm öğeleri seçilir.
stylers: Seçilen özellikler ve öğelere uygulanacak kurallar. Stil değiştiriciler, özelliğin rengini, görünürlüğünü ve ağırlığını belirtir. Bir özelliğe bir veya daha fazla stil uygulayabilirsiniz.

Bir stil belirtmek için bir dizi featureType ve elementType seçiciyi ve stylers öğenizi bir stil dizisiyle birleştirmeniz gerekir. Tek bir dizi içinde herhangi bir özellik kombinasyonunu hedefleyebilirsiniz. Ancak, tek seferde uygulayabileceğiniz stil sayısı sınırlıdır. Stil diziniz maksimum karakter sayısını aşıyorsa stil uygulanmaz.

Bu sayfanın geri kalanında özellikler, öğeler ve stil araçları hakkında daha fazla bilgi bulabilirsiniz.

`featureType`

Aşağıdaki JSON snippet'inde haritada tüm yollar seçilmiştir:

{
  "featureType": "road"
}

Özellikler veya özellik türleri, haritadaki coğrafi özelliklerdir (ör. yollar, parklar, su birimleri, işletmeler vb.).

Özellikler, kökü all olan bir kategori ağacı oluşturur. Bir özellik belirtmezseniz tüm özellikler seçilir. all özelliğini belirtmek de aynı etkiye sahiptir.

Bazı özellikler, nokta gösterimi kullanarak belirttiğiniz alt özellikler içerir. Örneğin, landscape.natural veya road.local. Yalnızca üst özelliği (ör. road) belirtirseniz üst öğe için belirttiğiniz stiller, road.local ve road.highway gibi tüm alt öğelere uygulanır.

Üst özelliklerin, tüm alt özelliklerine dahil edilmeyen bazı öğeler içerebileceğini unutmayın.

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

all (varsayılan) tüm özellikleri seçer.
administrative tüm idari bölgeleri seçer. Stil, coğrafi sınırları veya dolguyu değil, yalnızca idari bölgelerin etiketlerini etkiler.
- administrative.country ülkeleri seçer.
- administrative.land_parcel arazi parsellerini seçer.
- administrative.locality, yerellikleri seçer.
- administrative.neighborhood mahalleleri seçer.
- administrative.province il seçtiğinde
landscape tüm manzaraları seçer.
- landscape.man_made, binalar ve diğer yapılar gibi insan yapımı özellikleri seçer.
- landscape.natural dağ, nehir, çöl ve buzul gibi doğal özellikleri seçer.
- landscape.natural.landcover, ormanlar, çayırlar, sulak alanlar ve açık topraklar gibi dünyanın yüzeyini kaplayan fiziksel materyal olan arazi örtüsü özelliklerini seçer.
- landscape.natural.terrain, arazi yüzeyinin yükseklik, eğim ve yön gibi arazi özelliklerini seçer.
poi tüm önemli yerleri seçer.
- poi.attraction turistik yerleri seçiyor.
- poi.business işletmeleri seçer.
- poi.government resmi binaları seçer.
- poi.medical hastaneler, eczaneler, polis, doktorlar ve diğerleri dahil olmak üzere acil durum hizmetlerini seçer.
- poi.park parkları seçer.
- poi.place_of_worship, kiliseler, tapınaklar, camiler ve diğer ibadet yerleri dahil olmak üzere ibadet yerlerini seçer.
- poi.school okul 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çer.
- road.highway.controlled_access, erişim kontrollü otoyolları seçer.
- road.local yerel yolları seçer.
transit, tüm toplu taşıma istasyonlarını ve hatlarını 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çer.
- transit.station.rail, tren istasyonlarını seçer.
water, su kütlelerini seçer.

`elementType`

Aşağıdaki JSON snippet'inde tüm yerel yolların etiketleri seçilmiştir:

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

Öğeler, bir özelliğin alt bölümleridir. Örneğin, bir yol, haritada yer alan grafik çizgiden (geometri) ve adını belirten metinden (etiket) oluşur.

Aşağıdaki öğeler kullanılabilir ancak belirli bir özellik, öğelerin hiçbirini, bazılarını veya tamamını desteklemeyebilir:

all (varsayılan), belirtilen özelliğin tüm öğelerini seçer.
geometry, belirtilen özelliğin tüm geometrik öğelerini seçer.
- geometry.fill yalnızca özelliğin geometrisinin dolgusunu seçer.
- geometry.stroke yalnızca özelliğin geometrisinin çizgisini seçer.
labels, belirtilen özellikle ilişkili metin etiketlerini seçer.
- labels.icon yalnızca özelliğin etiketinde gösterilen simgeyi seçer.
- labels.text yalnızca etiketin metnini seçer.
- labels.text.fill yalnızca etiketin içini seçer. Bir etiketin dolgusu genellikle etiket metnini çevreleyen renkli bir dış çizgi olarak oluşturulur.
- labels.text.stroke, yalnızca etiketin metninin kalınlığını seçer.

`stylers`

Stil uygulayıcılar, harita özellikleri ve öğelerine uygulayabileceğiniz biçimlendirme seçenekleridir.

Aşağıdaki JSON snippet'inde, RGB değeri kullanılarak bir özellik parlak yeşil olarak gösterilmektedir:

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

Bu snippet, başlangıç renginden bağımsız olarak bir özelliğin rengindeki tüm yoğunlukları kaldırır. Bu işlem, özelliğin gri tonlamada oluşturulmasına neden olur:

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

Bu snippet, bir özelliği tamamen gizler:

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

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

hue (#RRGGBB biçiminde bir RGB onaltılık dizesi), temel rengi belirtir.
Not: Bu seçenek, varsayılan Google stilinde (veya haritada tanımladığınız diğer stil seçeneklerinde) belirtilen doygunluk ve açıklığı korurken tonu ayarlar. Elde edilen renk, temel haritanın stiline göre belirlenir. Google temel harita stilinde herhangi bir değişiklik yaparsa bu değişiklikler, haritanızın hue ile stilize edilen özelliklerini etkiler. Mümkünse mutlak color biçimlendiriciyi kullanmanız daha iyi olur.
lightness (-100 ile 100 arasında bir kayan nokta değeri), öğenin parlaklığındaki yüzdelik değişimi gösterir. Negatif değerler koyuluğu artırır (burada -100 değeri siyahı belirtir), pozitif değerler ise parlaklığı artırır (burada +100 değeri beyazı belirtir).
Not: Bu seçenek, varsayılan Google stilinde (veya haritada tanımladığınız diğer stil seçeneklerinde) belirtilen doygunluğu ve tonu korurken ışığı ayarlar. Elde edilen renk, temel haritanın stiline göre belirlenir. Google, temel harita stilinde herhangi bir değişiklik yaparsa bu değişiklikler, haritanızın lightness ile biçimlendirilmiş özelliklerini etkiler. Mümkünse mutlak color stilleştiriciyi kullanmak daha iyidir.
saturation (-100 ile 100 arasında kayan noktalı bir değer), öğeye uygulanacak temel rengin yoğunluğundaki yüzdelik değişimi belirtir.
Not: Bu seçenek, varsayılan Google stilinde (veya haritada tanımladığınız diğer stil seçeneklerinde) belirtilen ton ve açıklığı korurken doygunluğu ayarlar. Elde edilen renk, temel haritanın stiline göre belirlenir. Google, temel harita stilinde herhangi bir değişiklik yaparsa bu değişiklikler, haritanızın saturation ile biçimlendirilmiş özelliklerini etkiler. Mümkünse mutlak color stilleştiriciyi kullanmak daha iyidir.
gamma (0.01 ile 10.0 arasında bir kayan nokta değeri; burada 1.0 düzeltme uygulamaz), öğeye uygulanacak gama düzeltmesi miktarını gösterir. Gamma düzeltmeleri, beyaz veya siyah değerleri etkilemezken renklerin parlaklığını doğrusal olmayan bir şekilde değiştirir. Gama düzeltmesi genellikle birden fazla öğenin kontrastını değiştirmek için kullanılır. Örneğin, öğelerin kenarları ile iç kısımları arasındaki kontrastı artırmak veya azaltmak için gama ayarını değiştirebilirsiniz.
Not: Bu seçenek, bir gama eğrisi kullanarak varsayılan Google stiline göre ışığı ayarlar. Google temel harita stilinde herhangi bir değişiklik yaparsa bu değişiklikler, haritanızın gamma ile stilize edilen özelliklerini etkiler. Mümkünse mutlak color stillendiriciyi kullanmak daha iyidir.
invert_lightness (true ise) mevcut açıklığı tersine çevirir. Örneğin, beyaz metinlerin bulunduğu daha koyu bir haritaya hızlıca geçmek için bu özelliği kullanabilirsiniz.
Not: Bu seçenek, varsayılan Google stilini tersine çevirir. Google temel harita stilinde herhangi bir değişiklik yaparsa bu değişiklikler, haritanızın invert_lightness ile stilize edilen özelliklerini etkiler. Mümkünse mutlak color stilleştiriciyi kullanmak daha iyidir.
visibility (on, off veya simplified), öğenin haritada görünüp görünmediğini ve nasıl göründüğünü belirtir. simplified görünürlük, etkilenen özelliklerden bazı stil özelliklerini kaldırır. Örneğin, yollar, dış çizgileri olmayan daha ince çizgilere basitleştirilir. Parklar ise etiket metinlerini kaybeder ancak etiket simgelerini korur.
color (#RRGGBB biçimindeki bir RGB onaltılık dizesi), özelliğin rengini belirler.
weight (sıfır veya sıfırdan büyük bir tam sayı değeri), özelliğin ağırlığını piksel cinsinden belirler. Ağırlığı yüksek bir değere ayarlamak, karo kenarlarının kırpılmasına neden olabilir.

Stil kuralları, belirttiğiniz sırayla uygulanır. Birden fazla işlemi tek bir stil işleminde birleştirmeyin. Bunun yerine, her işlemi stil dizisinde ayrı bir giriş olarak tanımlayın.

Not: Bazı işlemler değişmeli olmadığından sıra önemlidir. Stil işlemleriyle değiştirilen özellikler ve/veya öğeler (genellikle) zaten mevcut stillere sahiptir. İşlemler, mevcut stiller varsa bu stiller üzerinde çalışır.

Ton, doygunluk, açıklık modeli

Not: Ton, doygunluk, açıklık ve gama ayarlarının etkisi, temel haritanın stiline bağlıdır. Google, temel harita stilinde herhangi bir değişiklik yaparsa bu değişiklikler, haritanızın bu seçeneklerle biçimlendirilmiş özelliklerini etkiler. Mümkünse mutlak color stil oluşturucuyu kullanmanız daha iyidir.

Stilize haritalar, stil uygulayıcı işlemleri sırasında rengi belirtmek için ton, doygunluk, açıklık (HSL) modelini kullanır. Ton temel rengi, doygunluk bu rengin yoğunluğunu, parlaklık ise oluşturan renkteki beyaz veya siyahın göreceli miktarını belirtir.

Gama düzeltmesi, genellikle kontrastı artırmak veya azaltmak için renk alanındaki parlaklığı değiştirir. Ayrıca HSL modeli, hue'ün bir renk tekerleği içindeki oryantasyonu, doygunluk ve açıklık ise farklı eksenler boyunca genlikleri gösterdiği bir koordinat alanında renk tanımlar. Tonlar, beyaz ve siyah tonlarının bulunmaması dışında çoğu RGB renk alanına benzer bir RGB renk alanında ölçülür.

Ton, doygunluk, açıklık modeli

hue, HTML onaltılık renk değerini alır ancak bu değeri yalnızca temel rengi belirlemek için kullanır. Yani, doygunluğunu veya açıklığını değil, renk tekerleğindeki yönünü yüzdelik değişim olarak ayrı ayrı gösterilen bu değeri kullanır.

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

RGB Renk Çarkı

Kırmızı, yeşil ve mavi renklerin eşit oranda yer aldığı RGB hue değerleri, HSL koordinat alanında bir yönelimi belirtmediği için ton belirtmez. "#000000" (siyah), "#FFFFFF" (beyaz) ve tüm saf gri tonları buna örnek olarak gösterilebilir. Siyah, beyaz veya griyi belirtmek için tüm saturation öğelerini kaldırmanız (değeri -100 olarak ayarlamanız) ve bunun yerine lightness değerini ayarlamanız gerekir.

Ayrıca, halihazırda bir renk şemasına sahip mevcut özellikler değiştirilirken hue gibi bir değerin değiştirilmesi, mevcut saturation veya lightness değerini değiştirmez.