Eso es todo.

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

Activar la Google Places API for Android

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 la Google Places API for Android
  3. Crear claves correspondientes
Continuar

Detalles e id. de sitio

Google Places API for Android le proporciona a tu aplicación gran cantidad de información sobre los sitios, incluido el nombre y la dirección del sitio, la ubicación geográfica especificada como coordenadas de latitud y longitud, el tipo de sitio (como un club nocturno, una tienda de mascotas, un museo), entre otros. Para acceder a esta información de un sitio específico, puedes usar el id. de sitio, un identificador estable que identifica un sitio de forma exclusiva.

  1. Detalles del sitio
  2. Obtener un sitio por id.
  3. Mostrar atribuciones en tu aplicación
  4. Más información sobre los id. de sitio

Detalles del sitio

El objeto Place proporciona información sobre un sitio específico. Puedes obtener un objeto Place de las siguientes maneras:

Usa los siguientes métodos para recuperar datos de un Place:

  • getName(): el nombre del sitio.
  • getAddress(): la dirección del sitio, en formato de lenguaje natural.
  • getID(): el identificador textual del sitio. Obtén más información sobre los id. de sitio en el resto de esta página.
  • getPhoneNumber(): el número de teléfono del sitio.
  • getWebsiteUri(): el URI del sitio web del sitio, en caso de ser conocido. Este es el sitio web que mantienen el negocio u otra entidad relacionada con el sitio. El resultado es nulo si no existe ningún sitio web conocido.
  • getLatLng(): la ubicación geográfica del sitio, especificada en coordenadas de latitud y longitud.
  • getViewport(): un viewport, que se devuelve como un objeto LatLngBounds y sirve para mostrar el sitio en el mapa. El resultado puede ser nulo si el tamaño del sitio no es conocido.
  • getLocale(): la configuración regional para la cual están localizadas el nombre y la dirección.
  • getPlaceTypes(): una lista de tipos de sitios que caracterizan este sitio en particular. Para acceder a una lista de los tipos de sitios disponibles, consulta la documentación de la interfaz de Place.
  • getPriceLevel(): el nivel de precio de este sitio, devuelto como valor entero que varía de 0 (el más económico) a 4 (el más costoso).
  • getRating(): una calificación agregada del sitio, que se devuelve como un flotante con valores que varían de 1,0 a 5,0, según las reseñas agregadas del usuario.

Algunos ejemplos simples:

final CharSequence name = place.getName();
final CharSequence address = place.getAddress();
final LatLng location = place.getLatLng();

Obtener un sitio por id.

Un id. de sitio es un identificador textual que identifica de forma exclusiva un sitio. En Google Places API for Android, puedes recuperar el id. de un sitio si realizas una llamada a Place.getId(). El servicio de autocompletado de sitios también devuelve un id. para cada sitio que coincida con el filtro y la consulta de búsqueda proporcionados. Puedes almacenar el id. de sitio y usarlo para recuperar el objeto Place nuevamente más tarde.

Para obtener un sitio por id., llama a GeoDataApi.getPlaceById y pasa uno o más id. de sitio.

La API devuelve un PlaceBuffer en un PendingResult. PlaceBuffer incluye una lista de objetos Place que coinciden con los id. de sitio proporcionados.

Places.GeoDataApi.getPlaceById(mGoogleApiClient, placeId)
    .setResultCallback(new ResultCallback<PlaceBuffer>() {
  @Override
  public void onResult(PlaceBuffer places) {
    if (places.getStatus().isSuccess() && places.getCount() > 0) {
      final Place myPlace = places.get(0);
      Log.i(TAG, "Place found: " + myPlace.getName());
    } else {
      Log.e(TAG, "Place not found");
    }
    places.release();
  }
});

Mostrar atribuciones en tu aplicación

Cuando en tu aplicación se muestra información obtenida de GeoDataApi.getPlaceById, también deben exhibirse atribuciones. Consulta la documentación sobre las atribuciones.

Más información sobre los id. de sitio

El id. de sitio usado en la Google Places API for Android es el mismo identificador empleado en el Google Places API Web Service.

Cada ID de sitio puede hacer referencia a un solo sitio, pero un sitio puede tener más de un ID de sitio. El caso más común para manejar varios ID de un sitio es aquel en el cual se agrega un sitio que, inicialmente, se encuentra dentro del ámbito de tu app y luego recibe un ámbito de la totalidad de Google.

Existen otras circunstancias que pueden hacer que un sitio reciba un nuevo ID de sitio. Esto, por ejemplo, puede suceder si un negocio se muda a otro lugar.

Cuando solicitas un sitio mediante la especificación de un id. de sitio, puedes estar seguro de que siempre recibirás el mismo sitio en la respuesta (si el sitio aún existe). Sin embargo, ten en cuenta que la respuesta puede incluir un id. de sitio diferente del que aparece en tu solicitud.

Para obtener más información, consulta la información general sobre id. de sitio.

Enviar comentarios sobre…