Descripción general

Selecciona la plataforma: Android iOS JavaScript Servicio web

Introducción

El SDK de Places para Android te permite compilar apps basadas en la ubicación que responden de manera contextual a las empresas locales y a otros lugares cerca del dispositivo del usuario. Esto significa que puedes compilar apps enriquecidas a partir de lugares que tienen alguna importancia para el usuario a fin de complementar los servicios directos basados en la ubicación geográfica que ofrecen los servicios de ubicación de Android.

Conceptos

Las siguientes interfaces brindan los principales puntos de entrada al SDK de Places para Android:

  • Places proporciona acceso programático a la base de datos de Google con información sobre las empresas y los lugares locales, además del lugar actual del dispositivo.
  • Autocomplete proporciona widgets prediseñados para mostrar predicciones de lugares en respuesta a las búsquedas de los usuarios.

Un lugar se define como un espacio físico que tiene un nombre. Otra manera de definir un lugar es que es cualquier lugar que se pueda encontrar en un mapa. Entre los ejemplos, se incluyen empresas locales, lugares de interés y ubicaciones geográficas. En la API, un lugar se representa con la interfaz Place. Incluye información como el nombre del lugar y su dirección, la ubicación geográfica, el ID de lugar, el número de teléfono, el tipo de lugar, la URL del sitio web y mucho más.

Elige tu versión del SDK

Las funciones del SDK de Places para Android que están disponibles en tu app se determinan mediante una combinación del número de versión del SDK (p.ej., 3.5.0) que especificas en la configuración de tu app, las APIs habilitadas en tu clave de API y la forma en que inicializas tu app. Para obtener más información sobre las diferencias entre el SDK de Places para Android y el SDK de Places para Android (nuevo), consulta Cómo elegir tu versión del SDK.

Tu primera tarea es decidir qué SDK usar. Esto es así si eres un cliente nuevo o un cliente existente que ya usa el SDK. Para conocer las diferencias clave entre las dos versiones del SDK, consulta Cómo elegir tu versión del SDK.

Precios para cada versión del SDK

La versión del SDK que habilites controla el precio de tu uso del SDK. El SDK de Places para Android (nuevo) admite un modelo de precios simplificado para que solo pagues por los datos que utilices. Si deseas obtener información detallada sobre los precios del SDK de Places para Android y el SDK de Places para Android (nuevo), consulta Uso y facturación.

Descripción general de la API

Ayuda a tus clientes a explorar dónde se encuentran y qué hay a su alrededor:

  • Place Autocomplete completa automáticamente el nombre o la dirección de un lugar mientras los usuarios escriben.
  • Current Place muestra una lista de los lugares en los que se sabe que se encuentra el dispositivo del usuario por última vez, junto con una indicación de la probabilidad relativa de cada lugar.
  • Place Details muestra y muestran información más detallada sobre un lugar.
  • Text Search muestra lugares en función de una string de texto de búsqueda. Text Search forma parte del SDK de Places para Android (versión nueva).
  • Place Photos devuelve imágenes de alta calidad de un lugar.
  • Los IDs de lugar almacenan el ID único de uno o más lugares para recuperar la información de los lugares a pedido.

Políticas y Términos

Todas las aplicaciones que utilizan el SDK de Places para Android deben cumplir con los requisitos que se describen en las Condiciones del Servicio de Google Maps Platform, el uso y la facturación, y cómo mostrar atribuciones.