APIs · Google

Descargar fotos de lugares por API

Cada foto que devuelve la Places API trae un name propio; con él descargas la imagen al tamaño que pidas. La regla que ahorra dinero y protege tu llave: descárgalas a archivos locales en tu build, no incrustes la URL de la API en el HTML.

Gratis Paso a paso Sin rodeos

1. Pide la foto y descárgala a un archivo

Primero incluye places.photos en el FieldMask de la búsqueda; cada resultado trae el name de sus fotos. Con ese nombre descargas la imagen:

curl -L -o lugar.jpg \
  "https://places.googleapis.com/v1/NOMBRE_DE_LA_FOTO/media?key=TU_API_KEY&maxWidthPx=1200"

Sustituye NOMBRE_DE_LA_FOTO por el name que devolvió la búsqueda y ajusta maxWidthPx al ancho que necesites.

No incrustes la URL en tu HTML

Descarga en el build, no en cada visita. Si pones la URL de la API directo en tu HTML, expones tu llave a cualquiera que vea el código y Google te cobra en cada carga de página. Descarga la imagen a un archivo local una vez y sirve ese archivo.

Cómo obtener la llave: conseguir una API key de Google. Detalle: descargar fotos con la Places API.

Tareas relacionadas

Preguntas frecuentes

¿Por qué no debo poner la URL de la foto de Places directo en mi HTML?

Por dos razones: la URL lleva tu API key, que quedaría visible para cualquiera que abra el código fuente, y cada carga de la imagen cuenta como una llamada facturable. Descargar la foto a un archivo local en el build evita ambos problemas.

¿Cómo controlo el tamaño de la imagen descargada?

Con el parámetro maxWidthPx (o maxHeightPx) en la URL. En el ejemplo, maxWidthPx=1200 pide la foto a 1200 píxeles de ancho. Pide solo el tamaño que vas a mostrar para no descargar imágenes más grandes de lo necesario.

¿De dónde saco el NOMBRE_DE_LA_FOTO?

De la propia búsqueda de Places: al incluir places.photos en el FieldMask, cada lugar devuelve sus fotos, y cada foto trae un campo name. Ese valor es el que va en la URL de descarga de la imagen.