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

Bulut tabanlı harita stilleri için JSON referansı

Platform seçin: Android iOS JavaScript Web Hizmeti

Bulut tabanlı harita stilinin JSON şeması, haritaları stil düzenleyici arayüzü üzerinden yaptığınız gibi özelleştirmek için JSON'u kullanmanıza olanak tanır. Bu belge, JSON şemasını ve JSON stilinde bildirimlerin nasıl yapılacağını açıklar.

JSON şemasını indirin

Stil düzenleyicide JSON kullanarak harita stilini düzenleme veya harita stilini içe ve dışa aktarma hakkında bilgi edinmek için Bulut tabanlı harita stiliyle JSON kullanma başlıklı makaleyi inceleyin.

Örnek JSON stil bildirimine bakın

Aşağıdaki JSON stil beyanı, arka plan rengini ayarlayıp ilgi çekici noktalar, parklar ve su kaynakları için stiller tanımlar, ayrıca yiyecek ve içecek yerlerinin etiketlerini gizler.


{
  "variant": "light",
  "styles": [
    {
      "id": "natural.land",
      "geometry": {
        "fillColor": "#f7e3f7"
      }
    },
    {
      "id": "natural.water",
      "geometry": {
        "fillColor": "#d4b2ff"
      },
      "label": {
        "textFillColor": "#3d2163",
        "textStrokeColor": "#f0e1ff"
      }
    },
    {
      "id": "pointOfInterest",
      "label": {
        "pinFillColor": "#e0349a",
        "textFillColor": "#a11e6e",
        "textStrokeColor": "#ffd9f0"
      }
    },
    {
      "id": "pointOfInterest.emergency.hospital",
      "geometry": {
        "fillColor": "#ffe3e3"
      }
    },
    {
      "id": "pointOfInterest.foodAndDrink",
      "label": {
        "visible": false
      }
    },
    {
      "id": "pointOfInterest.recreation.park",
      "geometry": {
        "fillColor": "#f9b9d2"
      }
    }
  ]
}

JSON nesnesi

JSON stil bildirimi, üst düzey bir nesne ve stil kuralları dizisinden oluşur.

Üst düzey ayarlar (isteğe bağlı): backgroundColor ve variant gibi genel stil ayarları.
styles - Aşağıdakilerden oluşabilen bir stil kuralı nesneleri dizisi:
- id: Bu stil değişikliği için seçilecek harita özelliği (ör. pointOfInterest.recreation.park).
- geometry (isteğe bağlı) - Harita özelliğinin geometrik öğeleri ve uygulanacak stil kuralları (ör. fillColor).
- label (isteğe bağlı): Harita özelliğinin metin veya raptiye etiketi ve uygulanacak stil kuralları (ör. textStrokeColor).

Üst düzey ayarlar

Aşağıdaki tablodaki özellikler harita stilinin tamamı için geçerlidir.

Özellik	Tür	Açıklama	Örnek
`backgroundColor`	Dize	#RRGGBB onaltılık dizesini kullanarak harita uygulamasının arka plan rengini özelleştirin. Bu ayar, opaklık değişikliklerini desteklemez.	"#002211"
`variant`	"light"\|"dark"	Açık veya koyu modu belirtin. Belirtilmemişse varsayılan olarak "light" kullanılır.	"light" (açık)
`monochrome`	boolean	Tek rengi etkinleştirmek için haritanın gri sürümünde `true` simgesini kullanın.	`true`

Stil kuralı nesneleri

Bu bölümde, harita özelliklerini özelleştirmek için styles dizisindeki stil kuralı nesnelerini tanımlayan özellikler açıklanmaktadır. Her stil kuralı nesnesi aşağıdakilerden oluşmalıdır:

id mülk.
geometry veya label öğesiyle birlikte, ilişkili stil özellikleri tanımlanır.

`id` (harita özelliği)

id özelliği, stil verilecek harita özelliğini belirtir. Özellik adları, stil düzenleyicideki harita özelliği adlarının camelcase sürümüdür.

Harita özellikleri bir kategori ağacı oluşturur. pointOfInterest gibi bir üst özellik türü belirtirseniz üst için belirttiğiniz stiller, pointOfInterest.retail ve pointOfInterest.lodging gibi tüm alt öğeleri için geçerli olur. Ayrıntılar için Harita özelliği hiyerarşisi başlıklı makaleyi inceleyin.

Kullanılabilir `id` özelliklerinin listesi

Kullanılabilir id özellikleri şunlardır:

pointOfInterest
pointOfInterest.emergency
pointOfInterest.emergency.fire
pointOfInterest.emergency.hospital
pointOfInterest.emergency.pharmacy
pointOfInterest.emergency.police
pointOfInterest.entertainment
pointOfInterest.entertainment.arts
pointOfInterest.entertainment.casino
pointOfInterest.entertainment.cinema
pointOfInterest.entertainment.historic
pointOfInterest.entertainment.museum
pointOfInterest.entertainment.themePark
pointOfInterest.entertainment.touristAttraction
pointOfInterest.foodAndDrink
pointOfInterest.foodAndDrink.bar
pointOfInterest.foodAndDrink.cafe
pointOfInterest.foodAndDrink.restaurant
pointOfInterest.foodAndDrink.winery
pointOfInterest.landmark
pointOfInterest.lodging
pointOfInterest.recreation
pointOfInterest.recreation.beach
pointOfInterest.recreation.boating
pointOfInterest.recreation.fishing
pointOfInterest.recreation.golfCourse
pointOfInterest.recreation.hotSpring
pointOfInterest.recreation.natureReserve
pointOfInterest.recreation.park
pointOfInterest.recreation.peak
pointOfInterest.recreation.sportsComplex
pointOfInterest.recreation.sportsField
pointOfInterest.recreation.trailhead
pointOfInterest.recreation.zoo
pointOfInterest.retail
pointOfInterest.retail.grocery
pointOfInterest.retail.shopping
pointOfInterest.service
pointOfInterest.service.atm
pointOfInterest.service.bank
pointOfInterest.service.carRental
pointOfInterest.service.evCharging
pointOfInterest.service.gasStation
pointOfInterest.service.parkingLot
pointOfInterest.service.postOffice
pointOfInterest.service.restStop
pointOfInterest.service.restroom
pointOfInterest.transit
pointOfInterest.transit.airport
pointOfInterest.other
pointOfInterest.other.bridge
pointOfInterest.other.cemetery
pointOfInterest.other.government
pointOfInterest.other.library
pointOfInterest.other.military
pointOfInterest.other.placeOfWorship
pointOfInterest.other.school
pointOfInterest.other.townSquare
political
political.countryOrRegion
political.border
political.reservation
political.stateOrProvince
political.city
political.sublocality
political.neighborhood
political.landParcel
infrastructure
infrastructure.building
infrastructure.building.commercial
infrastructure.businessCorridor
infrastructure.roadNetwork
infrastructure.roadNetwork.noTraffic
infrastructure.roadNetwork.noTraffic.pedestrianMall
infrastructure.roadNetwork.noTraffic.trail
infrastructure.roadNetwork.noTraffic.trail.paved
infrastructure.roadNetwork.noTraffic.trail.unpaved
infrastructure.roadNetwork.parkingAisle
infrastructure.roadNetwork.ramp
infrastructure.roadNetwork.road
infrastructure.roadNetwork.road.arterial
infrastructure.roadNetwork.road.highway
infrastructure.roadNetwork.road.local
infrastructure.roadNetwork.road.noOutlet
infrastructure.roadNetwork.roadShield
infrastructure.roadNetwork.roadSign
infrastructure.roadNetwork.roadDetail
infrastructure.roadNetwork.roadDetail.surface
infrastructure.roadNetwork.roadDetail.crosswalk
infrastructure.roadNetwork.roadDetail.sidewalk
infrastructure.roadNetwork.roadDetail.intersection
infrastructure.railwayTrack
infrastructure.railwayTrack.commercial
infrastructure.railwayTrack.commuter
infrastructure.transitStation
infrastructure.transitStation.bicycleShare
infrastructure.transitStation.busStation
infrastructure.transitStation.ferryTerminal
infrastructure.transitStation.funicularStation
infrastructure.transitStation.gondolaStation
infrastructure.transitStation.monorail
infrastructure.transitStation.railStation
infrastructure.transitStation.railStation.subwayStation
infrastructure.transitStation.railStation.tramStation
infrastructure.urbanArea
natural
natural.continent
natural.archipelago
natural.island
natural.land
natural.land.landCover
natural.land.landCover.crops
natural.land.landCover.dryCrops
natural.land.landCover.forest
natural.land.landCover.ice
natural.land.landCover.sand
natural.land.landCover.shrub
natural.land.landCover.tundra
natural.water
natural.water.ocean
natural.water.lake
natural.water.river
natural.water.other
natural.base

Öğeler

Öğeler, bir harita özelliğinin alt bölümleridir. Örneğin, bir yol, haritadaki grafik çizgiden (geometry) ve adını belirten metinden (label) oluşur.

Aşağıdaki öğeler kullanılabilir ancak belirli bir harita özelliğinin öğelerin hiçbirini, bazılarını veya tümünü destekleyebileceğini unutmayın:

geometry: Belirtilen harita özelliğinin tüm geometrik öğelerini (ör. poligon, çoklu çizgi) seçer.
label: Belirtilen harita özelliğinin tüm etiket öğelerini (ör. metin, raptiye) seçer.

Kıyafet bakım makineleri

Stil oluşturucular, bir harita özelliğinin her öğesi için stil kurallarınızı tanımlama şeklinizdir.

Örneğin, bir bina ayak izi için her öğeyi aşağıdaki gibi stilize edebilirsiniz:

Bir bina için örnek `geometry` stil belirleyicileri	Bir bina için örnek `label` stil belirleyicileri
Bina alanı poligonunun haritada gizlenip gizlenmeyeceği veya gösterilip gösterilmeyeceği.	Bina etiketinin gizlenip gizlenmeyeceği veya gösterilip gösterilmeyeceği.
Çokgen dolgu rengi ve opaklığı.	Metin dolgu rengi ve opaklığı
Kenarlık rengi, şeffaflık ve genişlik.	Metin kontur rengi ve opaklığı.

Bu bölümde, geometry ve label öğeleri için kullanılabilecek farklı stil seçenekleri açıklanmaktadır.

`geometry` stil oluşturucular

Aşağıdaki tabloda, kullanılabilen tüm geometrik stil oluşturucular listelenmiştir.

Styler	Tür	Açıklama
`visible`	boolean	Bir harita özelliğinin poligonunu veya çoklu çizgisini gizlemek için `false` olarak ayarlayın.
`fillColor`	dize	Poligonun veya çoklu çizginin rengini RGB onaltılık dizesiyle özelleştirin.
`fillOpacity`	kayan noktalı	Poligonun veya çoklu çizginin opaklığını özelleştirin. 0 değeri şeffaf, 1 değeri opaktır.
`strokeColor`	dize	Anahat rengini RGB onaltılık dizesiyle özelleştirin.
`strokeOpacity`	kayan noktalı	Çizginin opaklığını özelleştirin. 0 şeffaf, 1 ise opaktır.
`strokeWeight`	kayan noktalı	Anahat kalınlığını 0 ile 8 arasında bir değerle özelleştirin.

Daha fazla bilgi için Çokgenler ve Çoklu Çizgiler başlıklı makaleyi inceleyin.

`label` stil oluşturucular

Aşağıdaki tabloda, kullanılabilen tüm etiket stil araçları listelenmiştir.

Styler	Tür	Açıklama
`visible`	boolean	Bir harita özelliğinin etiketini gizlemek için `false` olarak ayarlayın.
`textFillColor`	dize	Metin etiketinin rengini RGB onaltılık dizesiyle özelleştirin.
`textFillOpacity`	kayan noktalı	Metin etiketinin opaklığını özelleştirin. 0 değeri şeffaf, 1 değeri ise opaktır.
`textStrokeColor`	dize	Anahat rengini RGB onaltılık dizesiyle özelleştirin.
`textStrokeOpacity`	kayan noktalı	Çizginin opaklığını özelleştirin. 0 şeffaf, 1 ise opaktır.
`textStrokeWeight`	kayan noktalı	Anahat kalınlığını 0 ile 8 arasında bir değerle özelleştirin.
`pinFillColor`	dize	RGB onaltılık dizesiyle raptiye rengini özelleştirin.

Daha fazla bilgi için Simgeler ve metin etiketleri başlıklı makaleyi inceleyin.

Keyzooms

Bir özellik için tüm yakınlaştırma seviyelerinde tek bir stil ayarlayabilir veya farklı yakınlaştırma seviyeleri için farklı stiller belirtebilirsiniz. Yalnızca bir stil sağlarsanız bu stil, z0'dan itibaren tüm yakınlaştırma düzeylerinde kullanılır. Farklı anahtar yakınlaştırma düzeyleri için stiller sağlarsanız stil, tanımladığınız bir sonraki yakınlaştırma düzeyine kadar geçerli olur.

Bir stil için ana yakınlaştırma düzeyi ayarlamak üzere stil oluşturucu özelliğinde ana yakınlaştırma düzeyini z0 ile z22 arasında tanımlayın ve ardından stil oluşturucu özelleştirmesini yapın.

Aşağıdaki örnekte, suyun rengi 0-5 ana yakınlaştırma seviyelerinde siyah, 6-11 ana yakınlaştırma seviyelerinde koyu gri ve 12 ana yakınlaştırma seviyesinden itibaren açık gridir.

{
  "id": "natural.water",
  "geometry": {
    "fillColor": {
      "z0": "#000000",
      "z6": "#666666",
      "z12": "#cccccc"
    }
  }
}

Daha fazla bilgi için Stil yakınlaştırma düzeyleri başlıklı makaleyi inceleyin.

Sınırlamalar

Google Cloud Console'daki neredeyse her şeyi stilize etmek için JSON'u kullanabilirsiniz. Ancak Harita Ayarları menüsündeki aşağıdaki özellikler hariçtir:

Bu özellikler için tercihinizi Harita Ayarları menüsünden seçmeniz gerekir.