Bulut tabanlı harita stilleri için JSON şeması, haritaları stil düzenleyici arayüzünde olduğu gibi JSON kullanarak özelleştirmenize olanak tanır. Bu belgede, JSON şeması ve JSON tarzı bildirimlerin nasıl yapılacağı açıklanmaktadır.
Stil düzenleyicide JSON kullanarak harita stilini nasıl düzenleyeceğinizi veya harita stilini nasıl içe ve dışa aktaracağınızı öğrenmek için Bulut tabanlı harita stilleriyle JSON kullanma başlıklı makaleyi inceleyin.
Örnek JSON stil beyanını inceleyin
Aşağıdaki JSON stil beyanı, bir arka plan rengi ayarlar ve ardından önemli yerler, parklar, su özellikleri için stiller tanımlar ve yiyecek ve içecek konumlarının 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 beyanı, üst düzey bir nesne ve stil kuralları dizisinden oluşur.
- Üst düzey özellikler (isteğe bağlı):
backgroundColorvevariantgibi 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 mülkler
Aşağıdaki tabloda yer alan özellikler, harita stilinin tamamı için geçerlidir.
| Özellik | Tür | Açıklama | Örnek |
|---|---|---|---|
|
Dize | #RRGGBB onaltılık dizesini kullanarak harita uygulamasının arka plan rengini özelleştirin. Bu ayar, opaklıkta yapılan değişiklikleri desteklemez. | "#002211" |
|
"light"|"dark" | Açık veya koyu modu belirtin. Belirtilmezse varsayılan değer "light" olur. | "light" |
|
boole | Tek rengi etkinleştirmek için haritanın gri sürümünde true kullanın. |
|
|
nesne | Stil tanımına dahil edilen rastgele anahtar/değer verileri. Stille ilgili, stil dışı içerikleri eklemek için bu alanı kullanabilirsiniz. Bu veriler, Maps JavaScript SDK gibi harita istemcilerine gönderilmez. |
|
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:
idmülk.- İlişkili stil özellikleri tanımlanmış
geometryveyalabelöğesi.
id (harita özelliği)
id özelliği, stil uygulanacak harita özelliğini belirtir. Özellik adları, stil düzenleyicideki harita özelliği adlarının camelCase sürümleridir.
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 özellik hiyerarşisi başlıklı makaleyi inceleyin.
Kullanılabilir id mülklerinin listesi
Kullanılabilir id özellikleri şunlardır:
pointOfInterestpointOfInterest.emergencypointOfInterest.emergency.firepointOfInterest.emergency.hospitalpointOfInterest.emergency.pharmacypointOfInterest.emergency.policepointOfInterest.entertainmentpointOfInterest.entertainment.artspointOfInterest.entertainment.casinopointOfInterest.entertainment.cinemapointOfInterest.entertainment.historicpointOfInterest.entertainment.museumpointOfInterest.entertainment.themeParkpointOfInterest.entertainment.touristAttractionpointOfInterest.foodAndDrinkpointOfInterest.foodAndDrink.barpointOfInterest.foodAndDrink.cafepointOfInterest.foodAndDrink.restaurantpointOfInterest.foodAndDrink.winerypointOfInterest.landmarkpointOfInterest.lodgingpointOfInterest.recreationpointOfInterest.recreation.beachpointOfInterest.recreation.boatingpointOfInterest.recreation.fishingpointOfInterest.recreation.golfCoursepointOfInterest.recreation.hotSpringpointOfInterest.recreation.natureReservepointOfInterest.recreation.parkpointOfInterest.recreation.peakpointOfInterest.recreation.sportsComplexpointOfInterest.recreation.sportsFieldpointOfInterest.recreation.trailheadpointOfInterest.recreation.zoopointOfInterest.retailpointOfInterest.retail.grocerypointOfInterest.retail.shoppingpointOfInterest.servicepointOfInterest.service.atmpointOfInterest.service.bankpointOfInterest.service.carRentalpointOfInterest.service.evChargingpointOfInterest.service.gasStationpointOfInterest.service.parkingLotpointOfInterest.service.postOfficepointOfInterest.service.restStoppointOfInterest.service.restroompointOfInterest.transitpointOfInterest.transit.airportpointOfInterest.otherpointOfInterest.other.bridgepointOfInterest.other.cemeterypointOfInterest.other.governmentpointOfInterest.other.librarypointOfInterest.other.militarypointOfInterest.other.placeOfWorshippointOfInterest.other.schoolpointOfInterest.other.townSquarepoliticalpolitical.countryOrRegionpolitical.borderpolitical.reservationpolitical.stateOrProvincepolitical.citypolitical.sublocalitypolitical.neighborhoodpolitical.landParcelinfrastructureinfrastructure.buildinginfrastructure.building.commercialinfrastructure.businessCorridorinfrastructure.roadNetworkinfrastructure.roadNetwork.noTrafficinfrastructure.roadNetwork.noTraffic.pedestrianMallinfrastructure.roadNetwork.noTraffic.trailinfrastructure.roadNetwork.noTraffic.trail.pavedinfrastructure.roadNetwork.noTraffic.trail.unpavedinfrastructure.roadNetwork.parkingAisleinfrastructure.roadNetwork.rampinfrastructure.roadNetwork.roadinfrastructure.roadNetwork.road.arterialinfrastructure.roadNetwork.road.highwayinfrastructure.roadNetwork.road.localinfrastructure.roadNetwork.road.noOutletinfrastructure.roadNetwork.roadShieldinfrastructure.roadNetwork.roadSigninfrastructure.roadNetwork.roadDetailinfrastructure.roadNetwork.roadDetail.surfaceinfrastructure.roadNetwork.roadDetail.crosswalkinfrastructure.roadNetwork.roadDetail.sidewalkinfrastructure.roadNetwork.roadDetail.intersectioninfrastructure.railwayTrackinfrastructure.railwayTrack.commercialinfrastructure.railwayTrack.commuterinfrastructure.transitStationinfrastructure.transitStation.bicycleShareinfrastructure.transitStation.busStationinfrastructure.transitStation.ferryTerminalinfrastructure.transitStation.funicularStationinfrastructure.transitStation.gondolaStationinfrastructure.transitStation.monorailinfrastructure.transitStation.railStationinfrastructure.transitStation.railStation.subwayStationinfrastructure.transitStation.railStation.tramStationinfrastructure.urbanAreanaturalnatural.continentnatural.archipelagonatural.islandnatural.landnatural.land.landCovernatural.land.landCover.cropsnatural.land.landCover.dryCropsnatural.land.landCover.forestnatural.land.landCover.icenatural.land.landCover.sandnatural.land.landCover.shrubnatural.land.landCover.tundranatural.waternatural.water.oceannatural.water.lakenatural.water.rivernatural.water.othernatural.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 araçları, bir harita özelliğinin her öğesi için stil kurallarınızı tanımlamanızı sağlar.
Örneğin, bir bina yerleşimi için her öğeyi aşağıdaki gibi stillendirebilirsiniz:
Bir bina için örnek geometry stil oluşturucular |
Bir bina için örnek label stil oluşturucular |
|---|---|
| Bina alanı poligonunun haritada gizlenip gizlenmeyeceği veya gösterilip gösterilmeyeceği. | Bina etiketinin gizlenip gizlenmeyeceğini belirler. |
| Poligon 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ılabilen farklı stil seçenekleri açıklanmaktadır.
geometry şekillendiriciler
Aşağıdaki tabloda, kullanılabilen tüm geometrik stil oluşturucular listelenmiştir.
| Styler | Tür | Açıklama |
|---|---|---|
|
boole | Bir harita özelliğinin poligonunu veya çoklu çizgisini gizlemek için false olarak ayarlayın. |
|
dize | RGB onaltılık dizesiyle çokgenin veya çoklu çizginin rengini özelleştirin. |
|
kayan noktalı | Poligonun veya çoklu çizginin opaklığını özelleştirin. 0 şeffaf, 1 ise opaktır. |
|
dize | Ana hattın rengini RGB onaltılık dizesiyle özelleştirin. |
|
kayan noktalı | Çizginin opaklığını özelleştirin. 0 şeffaf, 1 ise opaktır. |
|
kayan noktalı | Ana hattın kalınlığını 0 ile 8 arasında özelleştirin. |
Daha fazla bilgi için Çokgenler ve Çoklu Çizgiler başlıklı makaleyi inceleyin.
label şekillendirici
Aşağıdaki tabloda, kullanılabilen tüm etiket stil araçları listelenmiştir.
| Styler | Tür | Açıklama |
|---|---|---|
|
boole | Bir harita özelliğinin etiketini gizlemek için false olarak ayarlayın. |
|
dize | Metin etiketinin rengini RGB onaltılık dizesiyle özelleştirin. |
|
kayan noktalı | Metin etiketinin opaklığını özelleştirin. 0 şeffaf, 1 ise opaktır. |
|
dize | Ana hattın rengini RGB onaltılık dizesiyle özelleştirin. |
|
kayan noktalı | Çizginin opaklığını özelleştirin. 0 şeffaf, 1 ise opaktır. |
|
kayan noktalı | Anahat kalınlığını 0 ile 8 arasında bir değerle özelleştirin. |
|
dize | RGB onaltılık dizesiyle raptiye rengini özelleştirin. |
|
dize | Raptiyedeki glifin (simge) rengini RGB onaltılık dizesiyle özelleştirin. |
|
dize | Raptiye dış çizgisinin rengini RGB onaltılık dizesiyle özelleştirin. |
Daha fazla bilgi için Simgeler ve metin etiketleri başlıklı makaleyi inceleyin.
Keyzoom'lar
Bir özelliğin stilini tüm keyzoom seviyeleri için aynı olacak şekilde ayarlayabilir veya farklı keyzoom seviyeleri için farklı stiller belirleyebilirsiniz. Yalnızca bir stil sağlarsanız bu stil, z0'dan başlayan tüm keyzoom seviyeleri için kullanılır. Farklı keyzoom seviyeleri için stiller sağlarsanız stil, ilgili yakınlaştırma seviyesinden tanımladığınız bir sonraki seviyeye kadar uygulanır.
Bir stil için keyzoom seviyesi ayarlamak istiyorsanız stil oluşturucu özelliğinde keyzoom seviyesini 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 arasındaki keyzoom seviyelerinde siyah, 6-11 arasındaki keyzoom seviyelerinde koyu gri ve 12. keyzoom 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 seviyeleri başlıklı makaleyi inceleyin.
Sınırlamalar
Harita Ayarları menüsündeki aşağıdaki seçenekler hariç olmak üzere Google Cloud Console'daki neredeyse her öğeyi biçimlendirmek için JSON'u kullanabilirsiniz:
- Önemli yerlerin yoğunluğunu kontrol edin.
- Binaların görünümünü (planlar ve 3D) değiştirme
- Önemli yerlerin gösterimini (resimli ve standart) değiştirme
Bu harita düzeyi seçeneklerin doğru şekilde oluşturulması için karo verilerinin yeniden getirilmesi gerekir. Bu durum, belirli kullanım alanları için istenmeyen bir durum olabilir.
Bu seçenekler için tercihinizi Harita Ayarları menüsünde belirlemeniz gerekir.
Bu seçenekler dışa aktarılan stillere dahil edilmediğinden, stil içe aktarılırken Google Cloud Console'da yeniden seçilmeleri gerekir.