Cómo trabajar con un procesador de tarjetas en 3D

Desarrolladores del Espacio Económico Europeo (EEE)

Los mosaicos fotorrealistas en 3D están en el formato glTF estándar de OGC, lo que significa que puedes usar cualquier renderizador que admita la especificación de mosaicos en 3D de OGC para compilar tus visualizaciones en 3D. Por ejemplo, Cesium es una biblioteca fundamental de código abierto para renderizar visualizaciones en 3D.

Trabaja con CesiumJS

CesiumJS es una biblioteca de JavaScript de código abierto para la visualización en 3D en la Web. Para obtener más información sobre el uso de CesiumJS, consulta Aprende a usar CesiumJS.

Controles de usuario

El renderizador de mosaicos de CesiumJS tiene un conjunto estándar de controles de usuario.

Acción Descripción
Vista panorámica Haz clic con el botón izquierdo del mouse y arrastra
Vista de zoom Haz clic con el botón derecho del mouse y arrastra, o desplaza la rueda del mouse
Vista de rotación Presiona Ctrl y haz clic con el botón izquierdo o derecho del mouse y arrastra, o haz clic con el botón central del mouse y arrastra

Prácticas recomendadas

Existen varios enfoques que puedes adoptar para disminuir los tiempos de carga de CesiumJS 3D. Por ejemplo:

  • Para habilitar las solicitudes simultáneas, agrega la siguiente instrucción al HTML de renderización:

    Cesium.RequestScheduler.requestsByServer["tile.googleapis.com:443"] = <REQUEST_COUNT>

    Cuanto mayor sea el valor de REQUEST_COUNT, más rápido se cargarán los mosaicos. Sin embargo, cuando se carga en un navegador Chrome con un valor de REQUEST_COUNT superior a 10 y el caché inhabilitado, es posible que te encuentres con un problema conocido de Chrome. Para la mayoría de los casos de uso, recomendamos un valor de REQUEST_COUNT de 18 para obtener un rendimiento óptimo.

  • Habilita la omisión de niveles de detalle. Para obtener más información, consulta este problema de Cesium.

Para mostrar correctamente las atribuciones de datos, habilita showCreditsOnScreen: true. Para obtener más información, consulta Políticas.

Métricas de renderización

Para encontrar la velocidad de fotogramas, observa cuántas veces por segundo se llama al requestAnimationFrame.

Para ver cómo se calcula la latencia de fotogramas, consulta la PerformanceDisplay.

Ejemplos de renderizador de CesiumJS

Puedes usar el renderizador de CesiumJS con los mosaicos en 3D de la API de Map Tiles. Para ello, solo debes proporcionar la URL del conjunto de mosaicos raíz.

Ejemplo sencillo

En el siguiente ejemplo, se inicializa el renderizador de CesiumJS y, luego, se carga el conjunto de mosaicos raíz.

<!DOCTYPE html>
<head>
  <meta charset="utf-8">
  <title>CesiumJS 3D Tiles Simple Demo</title>
  <script src="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Cesium.js"></script>
  <link href="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Widgets/widgets.css" rel="stylesheet">
</head>
<body>
  <div id="cesiumContainer"></div>
  <script>

    // Enable simultaneous requests.
    Cesium.RequestScheduler.requestsByServer["tile.googleapis.com:443"] = 18;

    // Create the viewer.
    const viewer = new Cesium.Viewer('cesiumContainer', {
      imageryProvider: false,
      baseLayerPicker: false,
      geocoder: false,
      globe: false,
      // https://cesium.com/blog/2018/01/24/cesium-scene-rendering-performance/#enabling-request-render-mode
      requestRenderMode: true,
    });

    // Add 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(new Cesium.Cesium3DTileset({
      url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
      // This property is needed to appropriately display attributions
      // as required.
      showCreditsOnScreen: true,
    }));
  </script>
</body>

Para obtener información sobre requestRenderMode, consulta Habilita el modo de renderización de solicitudes.

La página HTML se renderiza como se muestra aquí.

Integración de la API de Places

Puedes usar CesiumJS con la API de Places para recuperar más información. Puedes usar el widget de Autocomplete para volar al viewport de Places. En este ejemplo, se usa la API de Places Autocomplete, que se habilita siguiendo estas instrucciones, y la API de Maps JavaScript, que se habilita siguiendo estas instrucciones.

<!DOCTYPE html>
<head>
 <meta charset="utf-8" />
 <title>CesiumJS 3D Tiles Places API Integration Demo</title>
 <script src="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Cesium.js"></script>
 <link href="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Widgets/widgets.css" rel="stylesheet">
</head>
<body>
 <label for="pacViewPlace">Go to a place: </label>
 <input
   type="text"
   id="pacViewPlace"
   name="pacViewPlace"
   placeholder="Enter a location..."
   style="width: 300px"
 />
 <div id="cesiumContainer"></div>
 <script>
   // Enable simultaneous requests.
   Cesium.RequestScheduler.requestsByServer["tile.googleapis.com:443"] = 18;

   // Create the viewer.
   const viewer = new Cesium.Viewer("cesiumContainer", {
     imageryProvider: false,
     baseLayerPicker: false,
     requestRenderMode: true,
     geocoder: false,
     globe: false,
   });

   // Add 3D Tiles tileset.
   const tileset = viewer.scene.primitives.add(
     new Cesium.Cesium3DTileset({
       url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
       // This property is required to display attributions as required.
       showCreditsOnScreen: true,
     })
   );

   const zoomToViewport = (viewport) => {
     viewer.entities.add({
       polyline: {
         positions: Cesium.Cartesian3.fromDegreesArray([
           viewport.getNorthEast().lng(), viewport.getNorthEast().lat(),
           viewport.getSouthWest().lng(), viewport.getNorthEast().lat(),
           viewport.getSouthWest().lng(), viewport.getSouthWest().lat(),
           viewport.getNorthEast().lng(), viewport.getSouthWest().lat(),
           viewport.getNorthEast().lng(), viewport.getNorthEast().lat(),
         ]),
         width: 10,
         clampToGround: true,
         material: Cesium.Color.RED,
       },
     });
     viewer.flyTo(viewer.entities);
   };

   function initAutocomplete() {
     const autocomplete = new google.maps.places.Autocomplete(
       document.getElementById("pacViewPlace"),
       {
         fields: [
           "geometry",
           "name",
         ],
       }
     );
     autocomplete.addListener("place_changed", () => {
       viewer.entities.removeAll();
       const place = autocomplete.getPlace();
       if (!place.geometry || !place.geometry.viewport) {
         window.alert("No viewport for input: " + place.name);
         return;
       }
       zoomToViewport(place.geometry.viewport);
     });
   }
 </script>
 <script
   async=""
   src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places&callback=initAutocomplete"
 ></script>
</body>

Vista de dron rotatoria

Puedes controlar la cámara para animar el conjunto de mosaicos. Cuando se combina con la API de Places y la API de Elevation, esta animación simula un sobrevuelo interactivo de un dron sobre cualquier punto de interés.

Esta muestra de código te permite volar por el lugar que seleccionaste en el widget de Autocomplete.

<!DOCTYPE html>
<head>
  <meta charset="utf-8" />
  <title>CesiumJS 3D Tiles Rotating Drone View Demo</title>
  <script src="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Cesium.js"></script>
  <link href="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Widgets/widgets.css" rel="stylesheet">
</head>
<body>
  <label for="pacViewPlace">Go to a place: </label>
  <input type="text" id="pacViewPlace" name="pacViewPlace" placeholder="Enter a location..." style="width: 300px" />
  <div id="cesiumContainer"></div>
  <script>
    // Enable simultaneous requests.
    Cesium.RequestScheduler.requestsByServer["tile.googleapis.com:443"] = 18;

    // Create the viewer and remove unneeded options.
    const viewer = new Cesium.Viewer("cesiumContainer", {
      imageryProvider: false,
      baseLayerPicker: false,
      homeButton: false,
      fullscreenButton: false,
      navigationHelpButton: false,
      vrButton: false,
      sceneModePicker: false,
      geocoder: false,
      globe: false,
      infobox: false,
      selectionIndicator: false,
      timeline: false,
      projectionPicker: false,
      clockViewModel: null,
      animation: false,
      requestRenderMode: true,
    });

    // Add 3D Tile set.
    const tileset = viewer.scene.primitives.add(
      new Cesium.Cesium3DTileset({
        url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",
        // This property is required to display attributions.
        showCreditsOnScreen: true,
      })
    );

    // Point the camera at a location and elevation, at a viewport-appropriate distance.
    function pointCameraAt(location, viewport, elevation) {
      const distance = Cesium.Cartesian3.distance(
        Cesium.Cartesian3.fromDegrees(
          viewport.getSouthWest().lng(), viewport.getSouthWest().lat(), elevation),
        Cesium.Cartesian3.fromDegrees(
          viewport.getNorthEast().lng(), viewport.getNorthEast().lat(), elevation)
      ) / 2;
      const target = new Cesium.Cartesian3.fromDegrees(location.lng(), location.lat(), elevation);
      const pitch = -Math.PI / 4;
      const heading = 0;
      viewer.camera.lookAt(target, new Cesium.HeadingPitchRange(heading, pitch, distance));
    }

    // Rotate the camera around a location and elevation, at a viewport-appropriate distance.
    let unsubscribe = null;
    function rotateCameraAround(location, viewport, elevation) {
      if(unsubscribe) unsubscribe();
      pointCameraAt(location, viewport, elevation);
      unsubscribe = viewer.clock.onTick.addEventListener(() => {
        viewer.camera.rotate(Cesium.Cartesian3.UNIT_Z);
      });
    }

    function initAutocomplete() {
      const autocomplete = new google.maps.places.Autocomplete(
        document.getElementById("pacViewPlace"), {
          fields: [
            "geometry",
            "name",
          ],
        }
      );

      autocomplete.addListener("place_changed", async () => {
        const place = autocomplete.getPlace();

        if (!(place.geometry && place.geometry.viewport && place.geometry.location)) {
          window.alert(`Insufficient geometry data for place: ${place.name}`);
          return;
        }
        // Get place elevation using the ElevationService.
        const elevatorService = new google.maps.ElevationService();
        const elevationResponse =  await elevatorService.getElevationForLocations({
          locations: [place.geometry.location],
        });

        if(!(elevationResponse.results && elevationResponse.results.length)){
          window.alert(`Insufficient elevation data for place: ${place.name}`);
          return;
        }
        const elevation = elevationResponse.results[0].elevation || 10;

        rotateCameraAround(
          place.geometry.location,
          place.geometry.viewport,
          elevation
        );
      });
    }
  </script>
  <script async src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&libraries=places&callback=initAutocomplete"></script>
</body>

Dibuja polilíneas y etiquetas

En esta muestra de código, se muestra cómo agregar polilíneas y etiquetas a un mapa. Puedes agregar polilíneas a un mapa para mostrar indicaciones para llegar en auto y a pie, o para mostrar los límites de la propiedad, o para calcular las duraciones de los viajes en auto y a pie. También puedes obtener atributos sin renderizar la escena.

Puedes llevar a los usuarios a un recorrido seleccionado por un vecindario o mostrar propiedades vecinas que estén a la venta y, luego, agregar objetos en 3D, como carteles publicitarios, a la escena.

Puedes resumir un viaje, enumerar las propiedades que viste y mostrar estos detalles en objetos virtuales.

<!DOCTYPE html>
<head>
  <meta charset="utf-8" />
  <title>CesiumJS 3D Tiles Polyline and Label Demo</title>
  <script src="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Cesium.js"></script>
  <link
    href="https://ajax.googleapis.com/ajax/libs/cesiumjs/1.105/Build/Cesium/Widgets/widgets.css"
    rel="stylesheet"
  />
</head>
<body>
  <div id="cesiumContainer"></div>
  <script>
    // Enable simultaneous requests.
    Cesium.RequestScheduler.requestsByServer["tile.googleapis.com:443"] = 18;

    // Create the viewer.
    const viewer = new Cesium.Viewer("cesiumContainer", {
      imageryProvider: false,
      baseLayerPicker: false,
      requestRenderMode: true,
      geocoder: false,
      globe: false,
    });

    // Add 3D Tiles tileset.
    const tileset = viewer.scene.primitives.add(
      new Cesium.Cesium3DTileset({
        url: "https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY",

        // This property is required to display attributions as required.
        showCreditsOnScreen: true,
      })
    );

    // Draws a circle at the position, and a line from the previous position.
    const drawPointAndLine = (position, prevPosition) => {
      viewer.entities.removeAll();
      if (prevPosition) {
        viewer.entities.add({
          polyline: {
            positions: [prevPosition, position],
            width: 3,
            material: Cesium.Color.WHITE,
            clampToGround: true,
            classificationType: Cesium.ClassificationType.CESIUM_3D_TILE,
          },
        });
      }
      viewer.entities.add({
        position: position,
        ellipsoid: {
          radii: new Cesium.Cartesian3(1, 1, 1),
          material: Cesium.Color.RED,
        },
      });
    };

    // Compute, draw, and display the position's height relative to the previous position.
    var prevPosition;
    const processHeights = (newPosition) => {
      drawPointAndLine(newPosition, prevPosition);

      const newHeight = Cesium.Cartographic.fromCartesian(newPosition).height;
      let labelText = "Current altitude (meters above sea level):\n\t" + newHeight;
      if (prevPosition) {
        const prevHeight =
          Cesium.Cartographic.fromCartesian(prevPosition).height;
        labelText += "\nHeight from previous point (meters):\n\t" + Math.abs(newHeight - prevHeight);
      }
      viewer.entities.add({
        position: newPosition,
        label: {
          text: labelText,
          disableDepthTestDistance: Number.POSITIVE_INFINITY,
          pixelOffset: new Cesium.Cartesian2(0, -10),
          showBackground: true,
          verticalOrigin: Cesium.VerticalOrigin.BOTTOM,
        }
      });

      prevPosition = newPosition;
    };

    const handler = new Cesium.ScreenSpaceEventHandler(viewer.canvas);
    handler.setInputAction(function (event) {
      const earthPosition = viewer.scene.pickPosition(event.position);
      if (Cesium.defined(earthPosition)) {
        processHeights(earthPosition);
      }
    }, Cesium.ScreenSpaceEventType.LEFT_CLICK);
  </script>
</body>

Órbita de la cámara

En Cesium, puedes orbitar la cámara alrededor de un punto de interés y evitar colisiones con edificios. Como alternativa, puedes hacer que los edificios sean transparentes cuando la cámara se mueve a través de ellos.

Primero, bloquea la cámara en un punto y, luego, puedes crear una órbita de la cámara para mostrar tu recurso. Para ello, usa la función lookAtTransform de la cámara con un objeto de escucha de eventos, como se muestra en esta muestra de código.

// Lock the camera onto a point.
const center = Cesium.Cartesian3.fromRadians(
  2.4213211833389243,
  0.6171926869414084,
  3626.0426275055174
);

const transform = Cesium.Transforms.eastNorthUpToFixedFrame(center);

viewer.scene.camera.lookAtTransform(
  transform,
  new Cesium.HeadingPitchRange(0, -Math.PI / 8, 2900)
);

// Orbit around this point.
viewer.clock.onTick.addEventListener(function (clock) {
  viewer.scene.camera.rotateRight(0.005);
});

Para obtener más información sobre cómo controlar la cámara, consulta Controla la cámara

Trabaja con Cesium para Unreal

Para usar el complemento Cesium para Unreal con la API de 3D Tiles, sigue los pasos que se indican a continuación.

  1. Instala el complemento Cesium para Unreal.

  2. Crea un proyecto nuevo de Unreal.

  3. Conéctate a la API de Google Photorealistic 3D Tiles.

    1. Para abrir la ventana de Cesium, selecciona Cesium > Cesium en el menú.

    2. Selecciona Blank 3D Tiles Tileset.

    3. En el World Outliner, selecciona este Cesium3DTileset para abrir el panel Details.

    4. Cambia Source de From Cesium Ion a From URL.

    5. Configura la URL como la URL de Google 3D Tiles.

    https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
    1. Habilita Show Credits On Screen para mostrar correctamente las atribuciones.

  4. Esto carga el mundo. Para moverte a cualquier LatLng, selecciona el elemento CesiumGeoreference en el panel Outliner y, luego, edita Origin Latitude/Longitude/Height en el panel Details.

Trabaja con Cesium para Unity

Para usar mosaicos fotorrealistas con Cesium para Unity, sigue los pasos que se indican a continuación.

  1. Crea un proyecto nuevo de Unity.

  2. Agrega un nuevo registro con alcance en la sección Package Manager (a través de Editor > Project Settings).

    • Nombre: Cesium

    • URL: https://unity.pkg.cesium.com

    • Alcances: com.cesium.unity

  3. Instala el paquete Cesium para Unity.

  4. Conéctate a la API de Google Photorealistic 3D Tiles.

    1. Para abrir la ventana de Cesium, selecciona Cesium > Cesium en el menú.

    2. Haz clic en Blank 3D Tiles Tileset.

    3. En el panel izquierdo, en la opción Tileset Source de Source, selecciona From URL (en lugar de From Cesium Ion).

    4. Configura la URL como la URL de Google 3D Tiles.

    https://tile.googleapis.com/v1/3dtiles/root.json?key=YOUR_API_KEY
    1. Habilita Show Credits On Screen para mostrar correctamente las atribuciones.

  5. Esto carga el mundo. Para moverte a cualquier LatLng, selecciona el CesiumGeoreference elemento en la jerarquía de escenas y, luego, edita el Origin Latitude/Longitude/Height en el Inspector.

Trabaja con deck.gl

deck.gl, con tecnología de WebGL, es un framework de JavaScript de código abierto para visualizaciones de datos de alto rendimiento, y a gran escala.

Atribución

Para mostrar correctamente las atribuciones de datos, extrae el campo copyright del asset de los mosaicos gltf y, luego, muéstralo en la vista renderizada. Para obtener más información, consulta Muestra atribuciones de datos.

Ejemplos de renderizador de deck.gl

Ejemplo sencillo

En el siguiente ejemplo, se inicializa el renderizador de deck.gl y, luego, se carga un lugar en 3D. En tu código, asegúrate de reemplazar YOUR_API_KEY por tu clave de API real.

<!DOCTYPE html>
<html>
 <head>
   <title>deck.gl Photorealistic 3D Tiles example</title>
   <script src="https://unpkg.com/deck.gl@latest/dist.min.js"></script>
   <style>
     body { margin: 0; padding: 0;}
     #map { position: absolute; top: 0;bottom: 0;width: 100%;}
     #credits { position: absolute; bottom: 0; right: 0; padding: 2px; font-size: 15px; color: white;
        text-shadow: -1px 0 black, 0 1px black, 1px 0 black, 0 -1px black;}
   </style>
 </head>

 <body>
   <div id="map"></div>
   <div id="credits"></div>
   <script>
     const GOOGLE_API_KEY = YOUR_API_KEY;
     const TILESET_URL = `https://tile.googleapis.com/v1/3dtiles/root.json`;
     const creditsElement = document.getElementById('credits');
     new deck.DeckGL({
       container: 'map',
       initialViewState: {
         latitude: 50.0890,
         longitude: 14.4196,
         zoom: 16,
         bearing: 90,
         pitch: 60,
         height: 200
       },
       controller: {minZoom: 8},
       layers: [
         new deck.Tile3DLayer({
           id: 'google-3d-tiles',
           data: TILESET_URL,
           loadOptions: {
            fetch: {
              headers: {
                'X-GOOG-API-KEY': GOOGLE_API_KEY
              }
            }
          },
           onTilesetLoad: tileset3d => {
             tileset3d.options.onTraversalComplete = selectedTiles => {
               const credits = new Set();
               selectedTiles.forEach(tile => {
                 const {copyright} = tile.content.gltf.asset;
                 copyright.split(';').forEach(credits.add, credits);
                 creditsElement.innerHTML = [...credits].join('; ');
               });
               return selectedTiles;
             }
           }
         })
       ]
     });
   </script>
 </body>
</html>

Visualiza capas 2D sobre los mosaicos fotorrealistas en 3D de Google

TerrainExtension de deck.gl renderiza datos 2D en una superficie 3D. Por ejemplo, puedes colocar el GeoJSON de una huella de edificio sobre la geometría de los mosaicos fotorrealistas en 3D.

En el siguiente ejemplo, se visualiza una capa de edificios con los polígonos adaptados a la superficie de los mosaicos fotorrealistas en 3D.

<!DOCTYPE html>
<html>
 <head>
   <title>Google 3D tiles example</title>
   <script src="https://unpkg.com/deck.gl@latest/dist.min.js"></script>
   <style>
     body { margin: 0; padding: 0;}
     #map { position: absolute; top: 0;bottom: 0;width: 100%;}
     #credits { position: absolute; bottom: 0; right: 0; padding: 2px; font-size: 15px; color: white;
        text-shadow: -1px 0 black, 0 1px black, 1px 0 black, 0 -1px black;}
   </style>
 </head>

 <body>
   <div id="map"></div>
   <div id="credits"></div>
   <script>
     const GOOGLE_API_KEY = YOUR_API_KEY;
     const TILESET_URL = `https://tile.googleapis.com/v1/3dtiles/root.json`;
     const BUILDINGS_URL = 'https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/google-3d-tiles/buildings.geojson'
     const creditsElement = document.getElementById('credits');
     const deckgl = new deck.DeckGL({
       container: 'map',
       initialViewState: {
         latitude: 50.0890,
         longitude: 14.4196,
         zoom: 16,
         bearing: 90,
         pitch: 60,
         height: 200
       },
       controller: true,
       layers: [
         new deck.Tile3DLayer({
           id: 'google-3d-tiles',
           data: TILESET_URL,
           loadOptions: {
            fetch: {
              headers: {
                'X-GOOG-API-KEY': GOOGLE_API_KEY
              }
            }
          },
          onTilesetLoad: tileset3d => {
             tileset3d.options.onTraversalComplete = selectedTiles => {
               const credits = new Set();
               selectedTiles.forEach(tile => {
                 const {copyright} = tile.content.gltf.asset;
                 copyright.split(';').forEach(credits.add, credits);
                 creditsElement.innerHTML = [...credits].join('; ');
               });
               return selectedTiles;
             }
           },
           operation: 'terrain+draw'
         }),
         new deck.GeoJsonLayer({
           id: 'buildings',
           // This dataset is created by CARTO, using other Open Datasets available. More info at: https://3dtiles.carto.com/#about.
           data: 'https://raw.githubusercontent.com/visgl/deck.gl-data/master/examples/google-3d-tiles/buildings.geojson',
           stroked: false,
           filled: true,
           getFillColor: ({properties}) => {
             const {tpp} = properties;
             // quantiles break
             if (tpp < 0.6249)
               return [254, 246, 181]
             else if (tpp < 0.6780)
               return [255, 194, 133]
             else if (tpp < 0.8594)
               return [250, 138, 118]
             return [225, 83, 131]
           },
           opacity: 0.2,
           extensions: [new deck._TerrainExtension()]
         })
       ]
     });
   </script>
 </body>
</html>

Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.

Última actualización: 2026-04-01 (UTC)