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

Agregado de sitios

Puedes usar Google Places API for Android para agregar un sitio a la base de datos de sitios de Google. El sitio agregado recientemente estará disponible para tu aplicación después de un período breve y se agrega a una cola de moderación para su posible adición a la base de datos de sitios de Google y a Google Maps.

  1. Agrega un sitio
  2. Maneja múltiples id. de sitio y ámbitos del id. de sitio

Agrega un sitio

Para agregar un sitio, realiza una llamada a GeoDataApi.addPlace() y pasa un objeto AddPlaceRequest que especifique los detalles del sitio que quieres agregar.

Cuando crees el objeto AddPlaceRequest, incluye la siguiente información:

  • Obligatorio: El valor textual completo de name para el negocio, el punto de interés u otro sitio. 255 caracteres como máximo.
  • Obligatorio: Un objeto LatLng que especifique la ubicación del sitio.
  • Obligatorio: El valor address del sitio en lenguaje natural. Si un sitio posee una dirección con formato correcto y en lenguaje natural, es más probable que apruebe el proceso de moderación para su posterior inclusión en la base de datos de Google Places.
  • Obligatorio: Una lista de tipos de sitios que caracterizan este sitio. Para acceder a una lista de los tipos de sitios disponibles, consulta la documentación de Tipos de sitios y las constantes definidas en la interfaz de Place.
  • Opcional: El valor phoneNumber del sitio. Este es el número telefónico en formato internacional. El formato internacional incluye el código de país y está precedido por un signo más (+). Por ejemplo, el número de teléfono internacional de la oficina de Google en Mountain View, Estados Unidos, es +1 650-253-0000. Si un sitio posee un número de teléfono con formato correcto, tendrá más probabilidades de aprobar el proceso de moderación para su posterior inclusión en la base de datos de Google Places. Nota: Debes proporcionar el valor de phoneNumber, Uri o ambos.
  • Opcional: Un objeto Uri que incluya la dirección del sitio web autorizado de este sitio, como la página de inicio de una empresa. Si un sitio posee una dirección del sitio web con formato correcto, es más probable que apruebe el proceso de moderación para su posterior inclusión en la base de datos de Google Places. Nota: Debes proporcionar el valor de phoneNumber, Uri o ambos.

La API devuelve un PlaceBuffer en un PendingResult. PlaceBuffer contiene el sitio agregado.

El objeto Place resultante tiene un id. de sitio único, que tu aplicación puede usar a partir de ese momento para recuperar los detalles del sitio. Los sitios agregados también están disponibles después de un período breve en los resultados de las solicitudes de obtención del sitio actual iniciadas por tu app y en un seleccionador de sitios que esta muestra. El ámbito estará determinado por el ID de proyecto usado para generar tu clave de API.

Los sitios agregados recientemente ingresan a una cola de moderación a fin de considerar su incorporación a la base de datos de Google Places. Los sitios que el proceso de moderación no acepte se podrán seguir recuperando mediante el id. de sitio en la aplicación que los envió, pero ya no aparecerán en los resultados de las solicitudes de obtención del sitio actual, el seleccionador de la API ni en ningún otro método de la API. Los sitios que pasen la moderación estarán visibles para todas las aplicaciones y en Google Maps.

Para aumentar las probabilidades de que el sitio apruebe el proceso de moderación y se agregue a la base de datos de Google Places, la solicitud de agregado debe incluir la mayor cantidad de información posible. En particular, es importante incluir la dirección, el número telefónico y el sitio web.

El siguiente ejemplo de código agrega un santuario de vida silvestre cerca de Manly, sobre la costa este de Australia.

AddPlaceRequest place =
    new AddPlaceRequest(
        "Manly Sea Life Sanctuary", // Name
        new LatLng(-33.7991, 151.2813), // Latitude and longitude
        "W Esplanade, Manly NSW 2095", // Address
        Collections.singletonList(Place.TYPE_AQUARIUM), // Place types
        "+61 1800 199 742", // Phone number
        Uri.parse("http://www.manlysealifesanctuary.com.au/") // Website
    );

Places.GeoDataApi.addPlace(mGoogleApiClient, place)
    .setResultCallback(new ResultCallback<PlaceBuffer>() {
        @Override
        public void onResult(PlaceBuffer places) {
            Log.i(TAG, "Place add result: " + places.getStatus().toString());
            Log.i(TAG, "Added place: " + places.get(0).getName().toString());
            places.release();
        }
    });

Maneja múltiples id. de sitio y ámbitos del id. de sitio

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.

Cuando agregas un sitio, recibes un id. de sitio para el nuevo sitio de inmediato. Este id. de sitio está definido solamente para el ámbito de tu aplicación. Luego, el sitio ingresa a una cola de moderación y espera la aprobación para ser agregado a la base de datos de Google Places. Si se aprueba, el sitio recibe un nuevo id. de sitio, que estará disponible para todas las aplicaciones y en Google Maps.

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...