Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
La API de Aerial View es un servicio que te permite crear y mostrar videos aéreos en 3D fotorrealistas de cualquier dirección física dentro de Estados Unidos. Los videos simulan imágenes tomadas por un dron sobrevolando la zona.
Google ya creó un conjunto de datos de videos de vista aérea renderizados previamente para que los uses. Cubren grandes edificios y lugares emblemáticos de todo Estados Unidos.
Además, agregamos más videos de vista aérea todo el tiempo. Puedes usar estos videos existentes o, si aún no hay un video para una dirección, puedes solicitar que Google genere uno nuevo para ti.
Por qué usar la API de Aerial View
Estos son algunos motivos por los que te recomendamos usar la API de Aerial View.
Quieres explorar datos en 3D, pero no te sientes cómodo usando 3D Tiles ni trabajando con un renderizador.
Te gusta el contexto de las imágenes satelitales y la capacidad de reconocer la fachada de un edificio desde Street View.
Consideraste contratar a un operador de drones para filmar tu propiedad.
Quieres usar tecnología innovadora y de vanguardia
Te sientes cómodo incorporando videos en tu sitio web.
Qué puedes hacer con la API de Aerial View
A continuación, se incluye una lista de algunas de las acciones que puedes realizar con la API de Aerial View.
Proporcionar una vista aérea de un edificio destacando las rutas, los parques o las masas de agua cercanos
Brindarles a los posibles inquilinos o compradores de viviendas una idea de cómo es una propiedad
Prepara la escena para un video de formato corto en el que se muestre al usuario dónde te encuentras
Destaca atracciones o lugares de interés cuando ayudes a los usuarios a planificar sus vacaciones
Ayuda a los conductores de entrega o compradores a encontrar tu lugar de trabajo
Cómo funciona la API de Aerial View
Existen dos enfoques que puedes adoptar para usar la API de Aerial View.
Enfoque
Razones
Cómo buscar un video generado
Google ya renderizó todas las imágenes aéreas que necesitas (conjunto de datos prerrenderizados de Google).
Generar un video nuevo
Necesitas imágenes de vista aérea que Google aún no haya prerrenderizado.
Áreas de cobertura
La API de Aerial View solo admite direcciones postales en Estados Unidos, donde Google puede renderizar videos en 3D.
Cómo usar la API de Aerial View
1
Revisa las Condiciones del Servicio de Google Maps Platform
Envía una dirección postal de EE.UU. o videoId al extremo lookupVideoMetadata() para devolver los metadatos de un video con vista aérea.
Consulta Cómo recuperar los metadatos de un video.
4
Cómo recuperar un video existente de vista aérea
Envía una dirección postal de EE.UU. o videoId al extremo lookupVideo() para devolver un video de vista aérea renderizado previamente.
Consulta Cómo recuperar un video generado.
5
Cómo generar un nuevo video de vista aérea
Envía una dirección postal de EE.UU. al extremo renderVideo() para solicitar la generación de un nuevo video de vista aérea de la dirección especificada.
Consulta Cómo generar un video nuevo.
[null,null,["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eThe Aerial View API lets you create and display photorealistic 3D aerial videos of US addresses, simulating drone footage.\u003c/p\u003e\n"],["\u003cp\u003eGoogle provides a pre-rendered video dataset for many locations, or you can request new videos to be generated.\u003c/p\u003e\n"],["\u003cp\u003eUse the API to enhance user experiences with interactive 3D aerial views for various applications, such as real estate, travel planning, and business listings.\u003c/p\u003e\n"],["\u003cp\u003eAccess and display videos through the API, but note that downloading or storing them locally is not permitted.\u003c/p\u003e\n"],["\u003cp\u003eThe API is limited to US addresses where 3D video rendering is supported by Google.\u003c/p\u003e\n"]]],[],null,["The Aerial View API is a service that lets you create and display\nphotorealistic 3D aerial videos of any physical address within the United\nStates. The videos simulate footage taken by a drone circling overhead.\n\nGoogle has already created a dataset of pre-rendered aerial view videos for you\nto use. They cover large buildings and landmarks throughout the United States.\nAnd we're adding more aerial view videos all the time. You can simply use these\nexisting videos or, if a video does not yet exist for an address, you can\nrequest that Google generate a new one for you.\n| **Note:** Google automatically pre-renders videos for addresses periodically, so some addresses will have no wait time.\n\nWhy use Aerial View API\n\nHere are some reasons why you might want to use Aerial View API.\n\n- You want to explore 3D data, but you're not comfortable using 3D Tiles, or with working with a renderer\n\n- You like the context of satellite imagery, and the ability to recognize a building facade from Street View\n\n- You've considered hiring a drone operator to film your property\n\n- You want to use cutting-edge, innovative technology\n\n- You're comfortable embedding video in your web site\n\nWhat you can do with Aerial View API\n\nHere's a list of some of the things you can do with Aerial View API.\n\n- Provide birds-eye awareness of a building by highlighting nearby roads, parks, or bodies of water\n\n- Give a prospective renter or home buyer a sense of what a property is like\n\n- Set the scene for a short-form video showing the viewer where you are\n\n- Highlight attractions or points-of-interest when helping users plan a vacation\n\n- Help delivery drivers or shoppers find your place of business\n\nHow the Aerial View API works\n\nThere are two approaches that you can take to use the Aerial View API.\n| **Tip:** Both of these approaches should begin with you checking whether the video exists using the [`lookupVideoMetadata`](/maps/documentation/aerial-view/lookup-video-metadata) endpoint.\n\n| Approach | Rationale |\n|--------------------------|--------------------------------------------------------------------------------------------------------------|\n| Lookup a generated video | All of the aerial imagery that you need has already been rendered by Google (Google's pre-rendered dataset). |\n| Generate a new video | You need aerial view imagery that hasn't already been pre-rendered by Google. |\n\nCoverage areas\n\nAerial View API only supports postal addresses in the United States where\nGoogle is able to render 3D videos.\n\nHow to use the Aerial View API\n\n|---|------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 1 | **Review the Google Maps Platform Terms of Service** | Note that you cannot download, store, or cache the aerial view videos. For more information, see the [Google Maps Platform Terms of Service](https://cloud.google.com/maps-platform/terms/). |\n| 2 | **Get set up** | Start with [Set up your Google Cloud project](/maps/documentation/aerial-view/cloud-setup) and complete the instructions that follow. |\n| 3 | **Retrieve an aerial view video's metadata** | Send a US postal address or `videoId` to the `lookupVideoMetadata()` endpoint to return an aerial view video's metadata. See [Retrieve a video's metadata.](/maps/documentation/aerial-view/lookup-video-metadata) |\n| 4 | **Fetch an existing aerial view video** | Send a US postal address or `videoId` to the `lookupVideo()` endpoint to return a pre-rendered aerial view video. See [Fetch a generated video.](/maps/documentation/aerial-view/lookup-video) |\n| 5 | **Generate a new aerial view video** | Send a US postal address to the `renderVideo()` endpoint to request the generation of a new aerial view video for the specified address. See [Generate a new video.](/maps/documentation/aerial-view/generate-video) |"]]
