Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Cloud ベースのマップのスタイル設定の JSON リファレンス

プラットフォームを選択: Android iOS JavaScript ウェブサービス

Cloud ベースのマップのスタイル設定の JSON スキーマを使用すると、スタイルエディタインターフェースと同じように JSON を使用して地図をカスタマイズできます。このドキュメントでは、JSON スキーマと JSON スタイル宣言の作成方法について説明します。

JSON スキーマをダウンロードする

スタイルエディタ内で JSON を使用して地図のスタイルを編集する方法、または地図のスタイルをインポートおよびエクスポートする方法については、 Cloud ベースのマップのスタイル設定で 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）。

最上位プロパティ

次の表のプロパティは、地図のスタイル全体に適用されます。

プロパティ	型	説明	例
`backgroundColor`	文字列	#RRGGBB 形式の 16 進文字列を使用して、地図アプリの背景色をカスタマイズします。この設定では、不透明度の変更はサポートされていません。	"#002211"
`variant`	"light"\|"dark"	ライトモードまたはダークモードを指定します。指定しない場合のデフォルトは「light」です。	"light"
`monochrome`	ブール値	モノクロを有効にするには、地図のグレーバージョンに `true` を使用します。	`true`
`metadata`	オブジェクト	スタイル定義に含まれる任意の Key-Value データ。このフィールドを使用して、スタイルに関連しないコンテンツを含めることができます。このデータは、Maps JavaScript SDK などの地図クライアントには送信されません。	`{"author": "me", "date": "2026-04-27"}`

スタイルルールオブジェクト

このセクションでは、地図対象物をカスタマイズするために styles 配列のスタイルルールオブジェクトを定義するプロパティについて説明します。各スタイルルールオブジェクトは、次の要素で構成する必要があります。

id プロパティ。
関連するスタイラプロパティが定義された geometry 要素または label 要素。

`id`（地図上の対象物）

id プロパティは、スタイルを設定する地図上の対象物を指定します。プロパティ名は、スタイルエディタの地図上の対象物名のキャメルケースバージョンです。

地図上の対象物は、カテゴリツリーを形成します。`pointOfInterest` などの親対象物の種類を指定すると、親に指定したスタイルが、`pointOfInterest.retail` や `pointOfInterest.lodging` などのすべての子に適用されます。詳しくは、地図上の対象物の階層をご覧ください。

使用可能な `id` プロパティのリスト

使用可能な id プロパティは次のとおりです。

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

要素

要素は、地図上の対象物の下位区分です。たとえば道路は、地図上のグラフィカルな線（geometry）と、道路の名称を示すテキスト（label）で構成されます。

次の要素が利用可能ですが、特定の地図上の対象物によっては、一部またはすべての要素に対応する場合や、すべての要素に非対応の場合があります。

geometry: 指定した地図上の対象物のすべてのジオメトリ要素（ポリゴン、ポリラインなど）を選択します。
label: 指定した地図上の対象物のすべてのラベル要素（テキスト、ピンなど）を選択します。

スタイラ

スタイラは、地図対象物の各要素のスタイルルールを定義する方法です。

たとえば、建物のフットプリントの場合、各要素のスタイルは次のように設定できます。

建物の `geometry` スタイラの例	建物の `label` スタイラの例
地図上に建物のフットプリントポリゴンを表示するか非表示にするか。	建物のラベルを表示するか非表示にするか。
ポリゴンの塗りつぶしの色と不透明度。	テキストの塗りつぶしの色と不透明度。
枠線の色、不透明度、幅。	テキストのストロークの色と不透明度。

このセクションでは、geometry 要素と label 要素で使用できるさまざまなスタイルオプションについて説明します。

`geometry` スタイラ

次の表に、使用可能なすべてのジオメトリスタイラを示します。

スタイラー	型	説明
`visible`	ブール値	地図上の対象物のポリゴンまたはポリラインを非表示にするには、`false` に設定します。
`fillColor`	文字列	RGB 形式の 16 進文字列を使用して、ポリゴンまたはポリラインの色をカスタマイズします。
`fillOpacity`	float	ポリゴンまたはポリラインの不透明度をカスタマイズします。0 は透明、1 は不透明です。
`strokeColor`	文字列	RGB 形式の 16 進文字列を使用して、枠線の色をカスタマイズします。
`strokeOpacity`	float	枠線の不透明度をカスタマイズします。0 は透明、1 は不透明です。
`strokeWeight`	float	枠線の太さを 0 ～ 8 の範囲でカスタマイズします。

詳しくは、ポリゴンとポリラインをご覧ください。

`label` スタイラ

次の表に、使用可能なすべてのラベルスタイラを示します。

スタイラー	型	説明
`visible`	ブール値	地図上の対象物のラベルを非表示にするには、`false` に設定します。
`textFillColor`	文字列	RGB 形式の 16 進文字列を使用して、テキストラベルの色をカスタマイズします。
`textFillOpacity`	float	テキストラベルの不透明度をカスタマイズします。0 は透明、1 は不透明です。
`textStrokeColor`	文字列	RGB 形式の 16 進文字列を使用して、枠線の色をカスタマイズします。
`textStrokeOpacity`	float	枠線の不透明度をカスタマイズします。0 は透明、1 は不透明です。
`textStrokeWeight`	float	枠線の太さを 0 ～ 8 の範囲でカスタマイズします。
`pinFillColor`	文字列	RGB 形式の 16 進文字列を使用して、ピンの色をカスタマイズします。
`pinGlyphColor`	文字列	RGB 形式の 16 進文字列を使用して、ピン内のグリフ（アイコン）の色をカスタマイズします。
`pinOutlineColor`	文字列	RGB 形式の 16 進文字列を使用して、ピンの枠線の色をカスタマイズします。

詳しくは、アイコンとテキストラベルをご覧ください。

キーズーム

すべてのキーズームレベルで対象物に単一のスタイルを設定することも、キーズームレベルごとに異なるスタイルを指定することもできます。スタイルを 1 つだけ指定すると、z0 から始まるすべてのキーズームレベルで使用されます。キーズームレベルごとにスタイルを指定すると、そのズームレベルから次に定義したズームレベルまでスタイルが適用されます。

スタイルのキーズームレベルを設定するには、スタイラプロパティで、z0 ～ z22 のキーズームレベルとスタイラのカスタマイズを定義します。

次の例では、水の色は keyzoom レベル 0 ～ 5 では黒、keyzoom レベル 6 ～ 11 では濃いグレー、keyzoom レベル 12 以降では薄いグレーになります。

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

詳しくは、ズームレベルのスタイルをご覧ください。

制限事項

JSON を使用して Google Cloud コンソール内のほぼすべての要素のスタイルを設定できますが、[地図の設定] メニューの次のオプションは除きます。

これらの地図レベルのオプションを正しくレンダリングするには、タイルデータを再取得する必要があります。これは、特定のユースケースでは望ましくない場合があります。

これらのオプションについては、 [設定] [**地図の設定**] メニューで設定する必要があります。

これらのオプションはエクスポートされたスタイルに含まれていないため、スタイルをインポートするときに Google Cloud コンソールで再選択する必要があります。

Cloud ベースのマップのスタイル設定の JSON リファレンス コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

JSON スタイル宣言の例を見る

JSON オブジェクト

最上位プロパティ

スタイルルール オブジェクト

id（地図上の対象物）

使用可能な id プロパティのリスト

要素

スタイラ

geometry スタイラ

label スタイラ

キーズーム

制限事項

Cloud ベースのマップのスタイル設定の JSON リファレンス

スタイルルールオブジェクト

`id`（地図上の対象物）

使用可能な `id` プロパティのリスト

`geometry` スタイラ

`label` スタイラ