Google Map Tiles - 2D Tiles - Display options When creating a 2D Google Map Tiles model, there are a number of display options:

2024.0

interface GoogleMapsTileSetModelCreateOptions {
    imageFormat?: "jpeg" | "png";
    language?: string;
    layerTypes?: ("layerRoadmap" | "layerStreetview" | "layerTraffic")[];
    mapType?: "roadmap" | "satellite" | "terrain";
    overlay?: boolean;
    region?: string;
    scale?: "scaleFactor1x" | "scaleFactor2x" | "scaleFactor4x";
    styles?: string;
}

Properties

imageFormat?: "jpeg" | "png"

Specifies the file format to return. Valid values are either jpeg or png. JPEG files don't support transparency, therefore they aren't recommended for overlay tiles. If you don't specify an imageFormat, then the best format for the tile is chosen automatically.

undefined, which means Google will automatically choose the best format.
language?: string

An IETF language tag that specifies the language used to display information on the tiles. For example, en-US specifies the English language as spoken in the United States.

"en-US"
layerTypes?: ("layerRoadmap" | "layerStreetview" | "layerTraffic")[]

An array of values that specifies the layer types added to the map. Valid values are:

  • layerRoadmap Required if you specify terrain as the map type. Can also be optionally overlaid on the satellite map type. Has no effect on roadmap tiles.
  • layerStreetview Shows Street View-enabled streets and locations using blue outlines on the map.
  • layerTraffic Displays current traffic conditions.
"layerRoadmap" for mapType "roadmap", undefined for other mapTypes,
which means Google will not add any extra overlays.
mapType?: "roadmap" | "satellite" | "terrain"

The type of base map. This value can be one of the following: roadmap, satellite, terrain

  • roadmap: The standard Google Maps painted map tiles.
  • satellite: Satellite imagery.
  • terrain: Terrain imagery. When selecting terrain as the map type, you must also include the layerRoadmap layer type (described in the Optional fields section).
"roadmap"
overlay?: boolean

A boolean value that specifies whether layerTypes should be rendered as a separate overlay (when true), or combined with the base imagery (when false). When true, the base map isn't displayed. If you haven't defined any layerTypes this value is ignored. If you defined layerTypes and overlay is true, you get transparent Google 2D Tiles ("png"). In this case you can display two or more raster layers on top of each other. Google 2D Tiles layer containing satellite data for example. You must configure such overlay raster layers with LayerType.STATIC or LayerType.DYNAMIC. Those are the layer types that you can place on top of LayerType.BASE layers.

undefined, which means Google will treat this as false.
region?: string

A Common Locale Data Repository region identifier (two uppercase letters) that represents the physical location of the user. For example, US.

"US"
scale?: "scaleFactor1x" | "scaleFactor2x" | "scaleFactor4x"

Scales-up the size of map elements (such as road labels), while retaining the tile size and coverage area of the default tile. Increasing the scale also reduces the number of labels on the map, which reduces clutter.

undefined, which mean Google will apply a scale factor of 1x.
styles?: string

An array of JSON style objects that specify the appearance and detail level of map features such as roads, parks, and built-up areas. Styling is used to customize the standard Google base map. The styles parameter is valid only if the map type is roadmap. For the complete style syntax, see the Style Reference.

undefined, which means Google will not apply custom styling.