Camadas
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Selecione a plataforma:
Android
JavaScript
Camadas são objetos no mapa que consistem em um ou mais itens separados, mas manipulados como uma unidade. As camadas geralmente refletem coleções de objetos adicionadas sobre o mapa para designar uma associação comum. A API Maps JavaScript gerencia a apresentação de objetos em camadas renderizando os itens constituintes deles em um objeto (geralmente, uma sobreposição de blocos) e mostrando-as como mudanças da janela de visualização do mapa. As camadas também podem mudar a camada de apresentação do próprio mapa, alterando um pouco os blocos básicos de forma consistente com a camada. Por padrão, não é possível acessar a maioria das camadas usando os objetos individuais. No entanto, elas só podem ser manipuladas como uma unidade.
Visão geral das camadas
A API Maps JavaScript tem vários tipos de camada:
- A camada de dados do Google Maps apresenta um contêiner para dados geoespaciais arbitrários.
Use a camada de dados para armazenar dados personalizados ou exibir dados GeoJSON em um mapa do Google Maps.
- A camada de mapa de calor renderiza dados geográficos usando uma visualização de mapa de calor.
- A camada KML renderiza elementos KML e GeoRSS em uma sobreposição de blocos da API Maps JavaScript.
- A camada de trânsito exibe as condições de trânsito no mapa.
- A camada de transporte público exibe a rede de transporte público da sua cidade no mapa.
- O objeto Camada de bicicleta renderiza uma camada de ciclovias e/ou sobreposições específicas de bicicletas em uma camada comum. Essa camada é retornada por padrão dentro de DirectionsRenderer ao solicitar rotas do meio de transporte bicicleta.
Adicionar uma camada
Para adicionar uma camada a um mapa, basta chamar setMap()
, passando o objeto do mapa em que a camada vai aparecer. Da mesma forma, para ocultar uma camada, chame setMap()
, transmitindo null
.
O snippet abaixo centraliza o mapa em Londres, Reino Unido, e adiciona a camada de transporte público.
var mapOptions = {
zoom: 13,
center: new google.maps.LatLng(51.5,-0.11)
}
var map = new google.maps.Map(document.getElementById("map"), mapOptions);
var transitLayer = new google.maps.TransitLayer();
transitLayer.setMap(map);
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-06 UTC.
[null,null,["Última atualização 2025-08-06 UTC."],[[["\u003cp\u003eLayers in Maps JavaScript API are objects consisting of multiple items that are treated as a single unit and often represent collections of objects on the map.\u003c/p\u003e\n"],["\u003cp\u003eThe API provides various layer types, including Data, Heatmap, KML, Traffic, Transit, and Bicycling layers, each serving a distinct purpose for displaying geospatial data.\u003c/p\u003e\n"],["\u003cp\u003eYou can easily add or hide a layer by calling the \u003ccode\u003esetMap()\u003c/code\u003e method, providing the map object or \u003ccode\u003enull\u003c/code\u003e respectively.\u003c/p\u003e\n"],["\u003cp\u003eThe example code demonstrates adding a Transit layer to a map centered on London.\u003c/p\u003e\n"]]],[],null,["Select platform: [Android](/maps/documentation/android-sdk/utility/multilayer \"View this page for the Android platform docs.\") [JavaScript](/maps/documentation/javascript/layers \"View this page for the JavaScript platform docs.\")\n\nLayers are objects on the map that consist of one or more separate items,\nbut are manipulated as a single unit. Layers generally reflect collections of\nobjects that you add on top of the map to designate a common association. The\nMaps JavaScript API manages the presentation of objects within layers\nby rendering their constituent items into one object (typically a tile overlay) and\ndisplaying them as the map's viewport changes. Layers may also alter the presentation\nlayer of the map itself, slightly altering the base tiles in a fashion\nconsistent with the layer. Note that most layers, by design, may not be\naccessed via their individual objects, but may only be manipulated as a\nunit.\n\nLayers Overview\n\nThe Maps JavaScript API has several types of layers:\n\n- The [**Google Maps Data\n layer**](/maps/documentation/javascript/datalayer) provides a container for arbitrary geospatial data. You can use the Data layer to store your custom data, or to display GeoJSON data on a Google map.\n- The [**Heatmap layer**](/maps/documentation/javascript/heatmaplayer) renders geographic data using a *Heatmap* visualization.\n- The [**KML layer**](/maps/documentation/javascript/kmllayer) renders KML and GeoRSS elements into a Maps JavaScript API tile overlay.\n- The [**Traffic layer**](/maps/documentation/javascript/trafficlayer#traffic_layer) displays traffic conditions on the map.\n- The [**Transit layer**](/maps/documentation/javascript/trafficlayer#transit_layer) displays the public transport network of your city on the map.\n- The [**Bicycling layer**](/maps/documentation/javascript/trafficlayer#bicycling_layer) object renders a layer of bike paths and/or bicycle-specific overlays into a common layer. This layer is returned by default within the **DirectionsRenderer** when requesting directions of travel mode **BICYCLING**.\n\nAdd a layer\n\nTo add a layer to a map, you only need to call `setMap()`,\npassing it the map object on which to display the layer. Similarly, to hide a\nlayer, call `setMap()`, passing `null`.\n\nThe below snippet centers the map on London, UK, and adds the [Transit\nlayer](/maps/documentation/javascript/trafficlayer#transit_layer). \n\n```javascript\nvar mapOptions = {\n zoom: 13,\n center: new google.maps.LatLng(51.5,-0.11)\n}\n\nvar map = new google.maps.Map(document.getElementById(\"map\"), mapOptions);\n\nvar transitLayer = new google.maps.TransitLayer();\ntransitLayer.setMap(map);\n```"]]