สคีมา JSON สำหรับการจัดรูปแบบแผนที่บนระบบคลาวด์ช่วยให้คุณใช้ JSON เพื่อ ปรับแต่งแผนที่ได้เช่นเดียวกับการใช้ผ่านอินเทอร์เฟซของเครื่องมือแก้ไขสไตล์ เอกสารนี้อธิบายสคีมา JSON และวิธีประกาศสไตล์ JSON
ดูวิธีแก้ไขรูปแบบแผนที่โดยใช้ JSON ภายในเครื่องมือแก้ไขรูปแบบ หรือวิธี นำเข้าและส่งออกรูปแบบแผนที่ได้ที่ ใช้ JSON กับการจัดรูปแบบแผนที่บนระบบคลาวด์
ดูตัวอย่างการประกาศรูปแบบ JSON
การประกาศรูปแบบ JSON ต่อไปนี้จะกำหนดสีพื้นหลัง แล้วกำหนด รูปแบบสำหรับจุดที่น่าสนใจ สวนสาธารณะ แหล่งน้ำ และซ่อนป้ายกำกับสำหรับสถานที่ตั้งของอาหาร และเครื่องดื่ม
{
  "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
การประกาศรูปแบบ JSON ประกอบด้วยออบเจ็กต์ระดับบนสุดและอาร์เรย์ของกฎรูปแบบ
- การตั้งค่าระดับบนสุด (ไม่บังคับ) - การตั้งค่ารูปแบบส่วนกลาง เช่น
backgroundColorและvariant styles- อาร์เรย์ของออบเจ็กต์กฎของรูปแบบ ซึ่งอาจประกอบด้วยรายการต่อไปนี้id- องค์ประกอบในแผนที่ที่จะเลือกสำหรับการแก้ไขรูปแบบนี้ (เช่นpointOfInterest.recreation.park)geometry(ไม่บังคับ) - องค์ประกอบทางเรขาคณิตของฟีเจอร์แผนที่ และกฎรูปแบบที่จะใช้ (เช่นfillColor)label(ไม่บังคับ) - ข้อความหรือป้ายกำกับหมุดขององค์ประกอบในแผนที่และ กฎรูปแบบที่จะใช้ (เช่นtextStrokeColor)
การตั้งค่าระดับบนสุด
พร็อพเพอร์ตี้ในตารางต่อไปนี้ใช้กับรูปแบบแผนที่ทั้งหมด
| พร็อพเพอร์ตี้ | ประเภท | คำอธิบาย | ตัวอย่าง | 
|---|---|---|---|
  | 
      สตริง | ปรับแต่งสีพื้นหลังของแอปแผนที่โดยใช้สตริงเลขฐานสิบหก #RRGGBB การตั้งค่านี้ไม่รองรับการเปลี่ยนแปลงความทึบแสง | "#002211" | 
  | 
      "light"|"dark" | ระบุโหมดสว่างหรือโหมดมืด หากไม่ได้ระบุ ค่าเริ่มต้นจะเป็น "สว่าง" | "light" | 
  | 
      บูลีน | หากต้องการเปิดใช้ขาวดำ ให้ใช้ true เพื่อดูแผนที่เวอร์ชันสีเทา | 
      
  | 
    
ออบเจ็กต์กฎรูปแบบ
ส่วนนี้จะอธิบายพร็อพเพอร์ตี้ที่กำหนดออบเจ็กต์กฎสไตล์ในอาร์เรย์ styles เพื่อปรับแต่งองค์ประกอบในแผนที่ ออบเจ็กต์กฎสไตล์แต่ละรายการต้องประกอบด้วยข้อมูลต่อไปนี้
idพร็อพเพอร์ตี้geometryหรือองค์ประกอบlabelที่กำหนดพร็อพเพอร์ตี้การจัดรูปแบบที่เชื่อมโยง
id (ฟีเจอร์แผนที่)
พร็อพเพอร์ตี้ id ระบุองค์ประกอบในแผนที่ที่จะจัดรูปแบบ ชื่อพร็อพเพอร์ตี้คือ
ชื่อฟีเจอร์แผนที่ในเครื่องมือแก้ไขรูปแบบที่เขียนในรูปแบบ Camel Case
ฟีเจอร์แผนที่จะสร้างโครงสร้างหมวดหมู่ หากคุณระบุประเภทฟีเจอร์หลัก เช่น pointOfInterest สไตล์ที่คุณระบุสำหรับฟีเจอร์หลักจะมีผลกับฟีเจอร์ย่อยทั้งหมด เช่น pointOfInterest.retail และ pointOfInterest.lodging
ดูรายละเอียดได้ที่ลำดับชั้นของฟีเจอร์แผนที่
รายการพร็อพเพอร์ตี้ id ที่พร้อมใช้งาน
พร็อพเพอร์ตี้ id ที่ใช้ได้มีดังนี้
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
องค์ประกอบ
องค์ประกอบคือส่วนย่อยของฟีเจอร์แผนที่ ตัวอย่างเช่น ถนน
ประกอบด้วยเส้นกราฟิก (geometry) บนแผนที่ และข้อความ
ที่ระบุชื่อ (label)
องค์ประกอบต่อไปนี้พร้อมใช้งาน แต่โปรดทราบว่าฟีเจอร์แผนที่บางอย่างอาจ ไม่รองรับ รองรับบางส่วน หรือรองรับทั้งหมด
geometry: เลือกองค์ประกอบทางเรขาคณิตทั้งหมด (เช่น รูปหลายเหลี่ยม โพลีไลน์) ของ ฟีเจอร์แผนที่ที่ระบุlabel: เลือกองค์ประกอบป้ายกำกับทั้งหมด (เช่น ข้อความ หมุด) ของฟีเจอร์แผนที่ที่ระบุ
ตู้ถนอมผ้า
Styler คือวิธีที่คุณกำหนดกฎสไตล์สำหรับองค์ประกอบแต่ละอย่างของฟีเจอร์แผนที่
ตัวอย่างเช่น สำหรับร่องรอยของอาคาร คุณสามารถจัดรูปแบบแต่ละองค์ประกอบได้ดังนี้
ตัวอย่างสไตเลอร์ geometry สำหรับอาคาร | 
      ตัวอย่างสไตเลอร์ label สำหรับอาคาร | 
    
|---|---|
| จะซ่อนหรือแสดงรูปหลายเหลี่ยมร่องรอยของอาคารบนแผนที่ | จะซ่อนหรือแสดงป้ายกำกับอาคาร | 
| สีและความทึบแสงของสีเติมรูปหลายเหลี่ยม | สีและความทึบแสงของสีเติมข้อความ | 
| สี ความทึบแสง และความกว้างของเส้นขอบ | สีและความทึบแสงของเส้นข้อความ | 
ส่วนนี้จะอธิบายตัวเลือกสไตล์ต่างๆ ที่ใช้ได้สำหรับองค์ประกอบ 
geometry และ label
geometry สไตลิสต์
ตารางต่อไปนี้แสดงรายการตัวจัดรูปแบบเรขาคณิตทั้งหมดที่ใช้ได้
| Styler | ประเภท | คำอธิบาย | 
|---|---|---|
  | 
      บูลีน | หากต้องการซ่อนรูปหลายเหลี่ยมหรือเส้นหลายส่วนของฟีเจอร์แผนที่ ให้ตั้งค่าเป็น false | 
    
  | 
      สตริง | ปรับแต่งสีของรูปหลายเหลี่ยมหรือเส้นหลายเส้นด้วยสตริงเลขฐานสิบหก RGB | 
  | 
      จำนวนลอยตัว | ปรับแต่งความทึบแสงของรูปหลายเหลี่ยมหรือเส้นหลายเส้น โดยที่ 0 คือ โปร่งใสและ 1 คือทึบแสง | 
  | 
      สตริง | ปรับแต่งสีของเส้นขอบด้วยสตริงเลขฐานสิบหก RGB | 
  | 
      จำนวนลอยตัว | ปรับแต่งความทึบแสงของเส้นขอบ โดย 0 คือโปร่งใสและ 1 คือ ทึบแสง | 
  | 
      จำนวนลอยตัว | ปรับแต่งความหนาของเส้นขอบได้ตั้งแต่ 0 ถึง 8 | 
ดูข้อมูลเพิ่มเติมได้ที่ รูปหลายเหลี่ยมและเส้นหลายส่วน
label สไตลิสต์
ตารางต่อไปนี้แสดงรายการตัวจัดรูปแบบป้ายกำกับทั้งหมดที่ใช้ได้
| Styler | ประเภท | คำอธิบาย | 
|---|---|---|
  | 
      บูลีน | หากต้องการซ่อนป้ายกำกับของฟีเจอร์แผนที่ ให้ตั้งค่าเป็น false | 
    
  | 
      สตริง | ปรับแต่งสีของป้ายกำกับข้อความด้วยสตริงเลขฐานสิบหก RGB | 
  | 
      จำนวนลอยตัว | ปรับแต่งความทึบแสงของป้ายกำกับข้อความ โดย 0 คือโปร่งใสและ 1 คือทึบแสง | 
  | 
      สตริง | ปรับแต่งสีของเส้นขอบด้วยสตริงเลขฐานสิบหก RGB | 
  | 
      จำนวนลอยตัว | ปรับแต่งความทึบแสงของเส้นขอบ โดย 0 คือโปร่งใสและ 1 คือ ทึบแสง | 
  | 
      จำนวนลอยตัว | ปรับแต่งความหนาของเส้นขอบได้ตั้งแต่ 0 ถึง 8 | 
  | 
      สตริง | ปรับแต่งสีหมุดด้วยสตริงเลขฐานสิบหก RGB | 
ดูข้อมูลเพิ่มเติมได้ที่ ไอคอนและป้ายกำกับข้อความ
คีย์ซูม
คุณสามารถตั้งค่าสไตล์เดียวสำหรับฟีเจอร์ในทุกระดับการซูมคีย์ หรือระบุ สไตล์ที่แตกต่างกันสำหรับระดับการซูมคีย์ที่แตกต่างกัน หากระบุรูปแบบเพียงรูปแบบเดียว ระบบจะใช้รูปแบบนั้นกับระดับการซูมทั้งหมดโดยเริ่มจาก z0 หากคุณระบุรูปแบบสำหรับ ระดับการซูมคีย์ที่แตกต่างกัน รูปแบบจะมีผลตั้งแต่ระดับการซูมนั้นจนถึง ระดับถัดไปที่คุณกำหนด
หากต้องการตั้งค่าระดับคีย์ซูมสำหรับสไตล์ ให้กำหนดระดับคีย์ซูม จาก z0 ถึง z22 ในพร็อพเพอร์ตี้ Stylers แล้วกำหนดการปรับแต่ง Stylers
ในตัวอย่างต่อไปนี้ สีของน้ำจะเป็นสีดำตั้งแต่ระดับคีย์ซูม 0-5 สีเทาเข้มตั้งแต่ระดับคีย์ซูม 6-11 และสีเทาอ่อนตั้งแต่ระดับคีย์ซูม 12
{
  "id": "natural.water",
  "geometry": {
    "fillColor": {
      "z0": "#000000",
      "z6": "#666666",
      "z12": "#cccccc"
    }
  }
}
ดูข้อมูลเพิ่มเติมได้ที่ระดับการซูมของสไตล์
ข้อจำกัด
คุณใช้ JSON เพื่อจัดรูปแบบแทบทุกอย่างใน Google Cloud Console ได้ ยกเว้นฟีเจอร์ต่อไปนี้จากเมนูการตั้งค่าแผนที่
สำหรับฟีเจอร์เหล่านี้ คุณต้องเลือกค่ากำหนดในเมนู การตั้งค่าแผนที่