Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar el Google Places API Web Service

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar el Google Places API Web Service
  3. Crear claves correspondientes
Continuar

Fotos de sitios

El servicio de Fotos de sitios, que forma parte de Google Places API Web Service, es una API de solo lectura que te permite agregar contenido fotográfico de alta calidad a tu aplicación. El servicio de Fotos de sitios te proporciona acceso a las millones de fotos almacenadas en la base de datos de Places y Google+ Local. Cuando obtienes información sobre sitios mediante una solicitud de detalles del sitio, se devolverán referencias de fotos para el contenido fotográfico relevante. Las solicitudes de búsqueda de sitios cercanos y de búsqueda de texto también devolverán la referencia de una foto por lugar, cuando sea relevante. A través del servicio de Fotos, puedes tener acceso a las fotos de referencia y cambiar el tamaño de la imagen al tamaño óptimo para tu aplicación.

Referencias de fotos

Todas las solicitudes del servicio de Fotos de sitios deben incluir una photoreference, devuelta en una respuesta a una solicitud de búsqueda de sitios cercanos, búsqueda de texto o detalles del sitio . Las respuestas a estas solicitudes contendrán un campo photos[] si el sitio tiene contenido fotográfico relacionado.

Nota: La cantidad de fotos devueltas varía según la solicitud.

  • Una búsqueda de sitios cercanos o una búsqueda de texto devolverá, al menos, un elemento photo en el conjunto.
  • Las búsquedas por radar no devuelven información sobre fotos.
  • Una solicitud de detalles devuelve hasta diez elementos photo.

Cada elemento photo contiene los siguientes campos:

  • photo_reference: una cadena utilizada para identificar la foto cuando realizas una solicitud de foto.
  • height: la altura máxima de la imagen.
  • width: el ancho máximo de la imagen.
  • html_attributions[]: contiene las atribuciones requeridas. Este campo estará siempre presente, pero puede estar vacío.

Las fotos devueltas por el servicio de fotos tienen origen en una variedad de ubicaciones, incluidas las fotos contribuidas por usuarios de Google+ y propietarios comerciales. En la mayoría de los casos, estas fotos se pueden usar sin atribución o tendrán la atribución requerida incluida como parte de la imagen. Sin embargo, si el elemento photo devuelto incluye un valor en el campo html_attributions, tendrás que incluir la atribución adicional en tu aplicación en cualquier lugar en donde muestres la imagen.

A continuación, se muestra un ejemplo de un conjunto de photos[].

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"

} ...

Solicitudes de fotos de sitios

Una solicitud de fotos de sitios es una HTTP URL como la siguiente:

https://maps.googleapis.com/maps/api/place/photo?parameters

Ciertos parámetros son obligatorios para iniciar una solicitud de búsqueda. Como es norma en las direcciones URL, todos los parámetros se separan con el carácter Y comercial (&). A continuación, se proporciona una lista de los parámetros y sus posibles valores.

Parámetros obligatorios

  • key: la clave de API de tu aplicación. Esa clave identifica tu aplicación a los fines de la administración de la cuota. Para obtener más información, consulta Obtener una clave.
  • photoreference: un identificador de cadenas que identifica en forma exclusiva una foto. Las referencias de fotos se devuelven a partir de una solicitud de búsqueda de sitios o de detalles del sitio.
  • maxheight o maxwidth: especifica la altura o el ancho máximos deseados, en píxeles, de la imagen devuelta por el servicio de Fotos de sitios . Si la imagen es más pequeña que los valores especificados, se devolverá la imagen original. Si la imagen es más grande en dimensión, se ajustará en escala para coincidir con la más pequeña de las dos dimensiones, restringida a su relación de aspecto original. Las propiedades maxheight y maxwidth aceptan un número entero entre 1 y 1600.

A continuación, se muestra una solicitud de ejemplo. Esta solicitud devuelve la imagen a la que hace referencia y cambia el tamaño de esta para que tenga, como máximo, unos 400 píxeles de ancho.

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Nota: Para que la solicitud funcione en tu aplicación, deberás reemplazar la clave de la API en este ejemplo.

Respuesta de fotos de sitios

La respuesta de una solicitud de fotos de sitios exitosa es una imagen. El tipo de imagen dependerá del tipo de foto enviada originalmente.

Si tu solicitud supera tu cuota disponible, el servidor devuelve un estado HTTP 403 y muestra la imagen pública que figura a continuación para indicar que se superó la cuota:

Imagen de cuota en exceso

Si el servidor no puede comprender tu solicitud, devuelve un estado HTTP 400, que indica una solicitud no válida. Entre los motivos más comunes por los que podrías ver una solicitud no válida se incluyen los siguientes:

  • La referencia de foto enviada se especificó de manera incorrecta.
  • Tu solicitud no incluyó un parámetro maxwidth o maxheight.

Mensajes de error

Cuando el servicio de Places devuelve un estado HTTP 400, podría haber un campo error_message adicional en el objeto de la respuesta. Este campo contiene información más detallada acerca de los motivos que subyacen al código de estado.

El parámetro sensor

Antes, Google Places API Web Service requería que incluyeras el parámetro sensor para indicar si tu aplicación usaba un sensor para determinar la ubicación del usuario. El uso de este parámetro ya no es obligatorio.

Enviar comentarios sobre...