Maps Static API'yi kullanırken kendi stillerinizi uygulayarak standart Google haritasının sunumunu özelleştirin. Yollar, parklar, yerleşim alanları ve diğer önemli yerler gibi özelliklerin görsel görünümünü değiştirebilirsiniz. Belirli bir içeriği vurgulamak, sayfanın etrafındaki içeriği tamamlamak veya özellikleri tamamen gizlemek için bunların renk veya stillerini değiştirebilirsiniz.
Örnekler
Aşağıdaki örnekte, ABD'nin Brooklyn kentine ait bir harita gösterilmektedir. Bu harita, yerel yolları parlak yeşil, yerleşim bölgesini ise siyah renklendirmektedir. Bu uygulama ayrıca etiketlerin açıklığını tersine çevirir, böylece koyu renkli bir arka planda daha iyi görünmelerini sağlar. Bu çalışan örneğin URL kodlamasını kullandığını unutmayın:
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=15¢er=Brooklyn&style=feature:road.local%7Celement:geometry%7Ccolor:0x00ff00&style=feature:landscape%7Celement:geometry.fill%7Ccolor:0x000000&style=element:labels%7Cinvert_lightness:true&style=feature:road.arterial%7Celement:labels%7Cinvert_lightness:false&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
![Stilli Brooklyn Haritası.](https://google-developers.gonglchuangl.net/static/maps/documentation/maps-static/images/brooklyn-map.png?authuser=0&hl=tr)
Aşağıdaki örnekte, bir ABD yol atlasının görünümünü tahmin etmek için stil işlemleri ve basitleştirmeler kullanılmaktadır:
https://maps.googleapis.com/maps/api/staticmap?size=512x512&zoom=12¢er=Chicago&format=png&style=feature:road.highway%7Celement:geometry%7Cvisibility:simplified%7Ccolor:0xc280e9&style=feature:transit.line%7Cvisibility:simplified%7Ccolor:0xbababa&style=feature:road.highway%7Celement:labels.text.stroke%7Cvisibility:on%7Ccolor:0xb06eba&style=feature:road.highway%7Celement:labels.text.fill%7Cvisibility:on%7Ccolor:0xffffff&key=YOUR_API_KEY&signature=DITIGAL_SIGNATURE
![ABD Yol Atlas Harita Stili.](https://google-developers.gonglchuangl.net/static/maps/documentation/maps-static/images/us-road-atlas-map.png?authuser=0&hl=tr)
Stil söz dizimi
Özelleştirilmiş bir stil haritası oluşturmak için istek URL'sine bir veya daha fazla style
parametresi ekleyin.
Her style
bildirimi, dikey çizgi karakterleriyle ("|
") ayrılmış aşağıdaki bağımsız değişkenleri içerebilir:
feature
(isteğe bağlı), bu stil değişikliği için seçilecek özellikleri belirtir. Özellikler, harita üzerindeki yollar, parklar veya diğer önemli yerler gibi şeyleri içerir.feature
bağımsız değişkeni yoksa belirtilen stil tüm özellikler için geçerli olur.element
(isteğe bağlı), bu stil değişikliği için seçilecek, belirtilen özelliğin öğelerini belirtir. Öğeler, bir özelliğin geometri veya etiketler gibi özellikleridir.element
bağımsız değişkeni yoksa stil, belirtilen özelliğin tüm öğelerine uygulanır.- Belirtilen özellik ve öğeler için geçerli olan bir stil kuralları grubu (zorunludur). API, kuralları
style
bildiriminde göründükleri sırayla uygular. Maps Static API'nin normal URL uzunluğu kısıtlamaları dahilinde istediğiniz sayıda kural ekleyebilirsiniz.
style=feature:myFeatureArgument|element:myElementArgument|myRule1:myRule1Argument|myRule2:myRule2Argument
Özellikler
Aşağıdaki style
beyanı, haritadaki tüm yolları renklendirir:
style=feature:road|color:0xffffff
Sık kullanılan özellik seçimlerinden bazıları şunlardır:
feature:all
(varsayılan), haritanın tüm özelliklerini seçer.feature:road
, haritadaki tüm yolları seçer.feature:road.local
tüm yerel yolları seçer.
Özellikler veya özellik türleri; yollar, parklar, su kütleleri, işletmeler ve daha fazlası dahil olmak üzere haritadaki coğrafi niteliklerdir.
Özellikler, kök olarak all
ile bir kategori ağacı oluşturur. Bir özellik belirtmezseniz tüm özellikler seçilir.
Bir all
özelliği belirtmek de aynı etkiye sahiptir.
Bazı özellikler, nokta gösterimi kullanarak belirttiğiniz alt özellikleri içerir. Örneğin, landscape.natural
veya road.local
. road
gibi yalnızca üst özelliği belirtirseniz üst öğe için belirttiğiniz stiller, tüm alt öğeleri (ör. road.local
ve road.highway
) için geçerli olur.
Üst özellikler, alt özelliklerin hepsine dahil olmayan bazı öğeleri içerebilir.
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 bağlı olduğu bölgelerin etiketlerini etkiler, coğrafi sınırları veya dolguyu etkilemez.administrative.country
ülke seçer.administrative.land_parcel
arsa paketlerini seçer.administrative.locality
şehirleri seçer.administrative.neighborhood
mahalleleri seçer.administrative.province
il seçer.
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ğlar, nehirler, çöller ve buzullar gibi doğal özellikleri seçer.landscape.natural.landcover
, yer örtüsü özelliklerini (ör. ormanlar, çayırlar, sulak alanlar ve çıplak topraklar gibi) dünyanın yüzeyini kaplayan fiziksel malzeme olarak seçer.landscape.natural.terrain
, bir kara 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
hükümet binalarını seçer.poi.medical
; hastaneler, eczaneler, polisler, doktorlar ve diğer acil durum hizmetlerini seçer.poi.park
, parkları seçer.poi.place_of_worship
kilise, tapınak, cami gibi ibadet yerlerini seçer.poi.school
okulları seçer.poi.sports_complex
spor komplekslerini seçer.
road
tüm yolları seçer.road.arterial
ana yolları seçer.road.highway
otoyolları seçer.road.highway.controlled_access
, kontrollü erişimle 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çer.transit.station
tüm toplu taşıma istasyonlarını seçer.- Havalimanlarını
transit.station.airport
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.
Öğeler
Aşağıdaki style
bildirimi, tüm yerel yollar için etiketleri renklendirir:
style=feature:road.local|element:labels|color:0xffffff
Öğeler, bir özelliğin alt bölümleridir. Örneğin bir yol, haritadaki grafik çizgiden (Geometri) ve adını belirten metinden (etiket) oluşur.
Aşağıdaki öğeler kullanılabilir ancak belirli bir özelliğin, öğelerin hiçbirini, bir kısmını veya tamamını desteklemeyebileceğini unutmayın:
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 dolgusunu seçer. Etiketin dolgusu genellikle etiket metnini çevreleyen renkli bir dış çizgi olarak oluşturulur.labels.text.stroke
yalnızca etiket metninin fırçasını seçer.
Stil kuralları
Stil kuralları, her style
bildiriminde belirtilen özelliklere ve öğelere uygulanan biçimlendirme seçenekleridir.
Aşağıdaki style
beyanı, haritadaki yollara iki stil kuralı uygular. İlk kural, yollara bir renk uygular. İkinci kural, yolların görünümünü basitleştirir. Böylece, dış çizgi içermeyen daha ince çizgiler olur:
style=feature:road|color:0xffffff|visibility:simplified
Her style
bildirimi dikey çizgi ("|
") karakteri kullanılarak ayrılmış bir veya daha fazla işlem içermelidir. Her işlem, iki nokta üst üste (":
") karakterini kullanarak kendi bağımsız değişken değerini belirtir ve tüm işlemler, belirttiğiniz sıraya göre seçime uygulanır.
Aşağıdaki stil seçenekleri desteklenir:
hue
(#RRGGBB
biçimindeki 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 belirler. Ortaya çıkan renk, temel haritanın stiline göre belirlenir. Google, temel harita stilinde değişiklik yaparsa bu değişiklikler haritanızın stili
hue
ile belirlenen özelliklerini etkiler. Mümkünse mutlakcolor
stil aracı kullanmak daha iyidir.lightness
(-100
ile100
arasında bir kayan nokta değeri), öğenin parlaklığındaki yüzdelik değişimi belirtir. Negatif değerler koyuluğu artırır (burada -100 siyahı belirtir), pozitif değerler parlaklığı artırır (+100 beyazı belirtir).Not: Bu seçenek, varsayılan Google stilinde (veya haritada tanımladığınız diğer stil seçeneklerinde) belirtilen doygunluk ve tonu korurken ışığı ayarlar. Ortaya çıkan renk, temel haritanın stiline göre belirlenir. Google, temel harita stilinde değişiklik yaparsa bu değişiklikler haritanızın stili
lightness
ile belirlenen özelliklerini etkiler. Mümkünse mutlakcolor
stil aracı kullanmak daha iyidir.saturation
(-100
ile100
arasında bir kayan nokta değeri), öğeye uygulanacak temel rengin yoğunluğundaki yüzde değişimini 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. Ortaya çıkan renk, temel haritanın stiline göre belirlenir. Google, temel harita stilinde değişiklik yaparsa bu değişiklikler haritanızın stili
saturation
ile belirlenen özelliklerini etkiler. Mümkünse mutlakcolor
stil özelliklerini kullanmak daha iyidir.gamma
(0.01
ile10.0
arasında olup1.0
düzeltme uygulamadığında kayan nokta değeri), öğeye uygulanacak gama düzeltmesi miktarını belirtir. Gama düzeltmeleri, renklerin açıklığını doğrusal olmayan bir şekilde değiştirir, beyaz veya siyah değerlerini etkilemez. Gama düzeltmesi genellikle birden fazla öğenin kontrastını değiştirmek için kullanılır. Örneğin, öğelerin kenarları ve iç kısımları arasındaki kontrastı artırmak veya azaltmak için gama üzerinde değişiklik yapabilirsiniz.Not: Bu seçenek, ışığı bir gama eğrisi kullanarak varsayılan Google stiline göre ayarlar. Google, temel harita stilinde değişiklik yaparsa bu değişiklikler haritanızın stili
gamma
ile belirlenen özelliklerini etkiler. Mümkünse mutlakcolor
stil cihazı kullanmak daha iyidir.invert_lightness
(true
ise) mevcut ışığı tersine çevirir. Bu, örneğin beyaz metin içeren daha koyu bir haritaya hızlıca geçiş yapmak için yararlıdır.Not: Bu seçenek varsayılan Google stilini tersine çevirir. Google, temel harita stilinde değişiklik yaparsa bu değişiklikler haritanızın stili
invert_lightness
ile belirlenen özelliklerini etkiler. Mümkünse mutlakcolor
stil özelliklerini kullanmak daha iyidir.visibility
(on
,off
veyasimplified
), öğenin haritada olup olmadığını ve nasıl görüneceğini belirtir.simplified
görünürlüğü, bazı stil özelliklerini etkilenen özelliklerden kaldırır. Örneğin, yollar dış çizgi olmadan daha ince çizgilerle sadeleştirilir, parklar ise etiket metnini kaybeder ancak etiket simgesini korur.color
(#RRGGBB
biçimindeki RGB onaltılık dizesi) özelliğin rengini belirler.weight
(sıfıra eşit veya sıfırdan büyük bir tam sayı değeri), özelliğin ağırlığını piksel cinsinden ayarlar. Ağırlığın yüksek bir değere ayarlanması, karo kenarlıklarının yakınında kırpmaya neden olabilir.
Stil kuralları belirttiğiniz sıraya göre uygulanır. Birden fazla işlemi tek bir stilde birleştirmeyin. Bunun yerine, her işlemi stil dizisinde ayrı bir giriş olarak tanımlayın.
Not: Bazı işlemler değişimli olmadığından sıralama önemlidir. Stil işlemleri aracılığıyla değiştirilen özelliklerin ve/veya öğelerin (genellikle) zaten mevcut stilleri vardır. İşlemler, varsa bu mevcut stillere göre hareket eder.
Ton, doygunluk, açıklık modeli
Stilli haritalar, stil aracı işlemlerindeki rengi belirtmek için ton, doygunluk, açıklık (HSL) modelini kullanır. Ton temel rengi, doygunluk bu rengin yoğunluğunu ve açıklık, bileşen rengin göreli beyaz veya siyah miktarını belirtir.
Gama düzeltme, genellikle kontrastı artırmak veya azaltmak için renk alanı üzerindeki ışığı değiştirir. Buna ek olarak, HSL modeli bir koordinat alanında renk tanımlar. Burada hue
bir renk çemberi içindeki yönü belirtirken, doygunluk ve açıklık farklı eksenler boyunca genliği belirtir. Tonlar, RGB renk alanında ölçülür. RGB renk alanı, beyaz ve siyah tonların kullanılmadığı çoğu RGB renk alanına benzer.
hue
, HTML onaltılık renk değerini alırken, bu değeri yalnızca temel rengi, yani yüzde değişimi olarak ayrı ayrı belirtilen doygunluk veya açıklığı değil, renk çemberinin etrafındaki yönünü belirlemek için 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ı
Eşit miktarda kırmızı, yeşil ve maviden oluşan RGB hue
değerleri, bu değerlerin hiçbiri HSL koordinat alanında bir yön belirtmediği için
bir ton belirtmez. "#000000" (siyah), "#FFFFFF" (beyaz) ve tüm gri tonları bunlara örnek olarak verilebilir. Siyah, beyaz veya gri belirtmek için tüm saturation
öğelerini kaldırmanız (değeri -100
olarak ayarlayın) ve bunun yerine lightness
değerini ayarlamanız gerekir.
Ayrıca, halihazırda renk şeması olan mevcut özellikler değiştirilirken hue
gibi bir değerin değiştirilmesi, mevcut saturation
veya lightness
değerini değiştirmez.