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

Agregado de sitios

Al agregar un sitio, puedes complementar los datos de la base de datos de Google Maps con los datos de tu aplicación. Esto te permite hacer lo siguiente:

  • Actualizar instantáneamente los datos de la base de datos de Google para tus usuarios.
  • Enviar nuevos sitios a una cola de moderación para agregarlos a la base de datos de Google Places.
  • Diferenciar tu aplicación de otras aplicaciones con una funcionalidad similar.
  • Crear aplicaciones orientadas a una base de usuarios o a una ubicación geográfica específica.
  • Influir en los resultados de una búsqueda de sitios realizada desde tu aplicación.
  1. Información general
  2. Agrega un sitio
  3. Elimina un sitio
  4. Códigos de estado
  5. Mensajes de error
  6. El parámetro sensor

Información general

Cuando agregas un sitio, este se encuentra disponible de inmediato en las búsquedas de sitios cercanos iniciadas por tu aplicación. El nuevo sitio también ingresa a una cola de moderación a fin de tenerlo en cuenta para Google Maps. Un sitio agregado recientemente no aparece en los resultados de la búsqueda de texto ni por radar, ni está disponible para otras aplicaciones hasta ser aprobado por el proceso de moderación.

También puedes eliminar los sitios que haya agregado tu aplicación antes de que sean moderados. Una vez moderados y agregados a la base de datos de Google, ya no es posible eliminar sitios. Los sitios no aceptados por el proceso de moderación continuarán estando visibles para la aplicación que los envió.

Agrega un sitio

Una solicitud de agregado de sitios es una solicitud HTTP POST similar al ejemplo que se indica a continuación:


JSON
POST https://maps.googleapis.com/maps/api/place/add/json?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

{
  "location": {
    "lat": -33.8669710,
    "lng": 151.1958750
  },
  "accuracy": 50,
  "name": "Google Shoes!",
  "phone_number": "(02) 9374 4000",
  "address": "48 Pirrama Road, Pyrmont, NSW 2009, Australia",
  "types": ["shoe_store"],
  "website": "http://www.google.com.au/",
  "language": "en-AU"
}
      
XML
POST https://maps.googleapis.com/maps/api/place/add/xml?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

<PlaceAddRequest>
  <location>
    <lat>-33.8669710</lat>
    <lng>151.1958750</lng>
  </location>
  <accuracy>50</accuracy>
  <name>Google Shoes!</name>
  <phone_number>(02) 9374 4000</phone_number>
  <address>48 Pirrama Road, Pyrmont, NSW 2009, Australia</address>
  <type>shoe_store</type>
  <website>http://www.google.com.au/</website>
  <language>en-AU</language>
</PlaceAddRequest>
      

Ten en cuenta que la ruta de acceso de la dirección URL indica el formato de entrada y salida:

  • json (recomendado) indica el formato de entrada y salida en JavaScript Object Notation (JSON).
  • xml indica el formato de entrada y salida como XML.

La dirección URL debe contener el siguiente parámetro:

  • key: la clave de API de tu aplicación. Esta clave identifica tu aplicación a los fines de la administración de la cuota, de modo que los sitios agregados desde tu aplicación estén inmediatamente disponibles en ella. Para obtener más información, consulta Obtener una clave.

El cuerpo de la solicitud contiene información acerca del sitio. Se debe estructurar de acuerdo con el parámetro output especificado (JSON o XML).

  • accuracy: la precisión de la señal de ubicación en la que se basa esta solicitud, expresada en metros.
  • address (recomendado para aumentar las posibilidades de aprobar la moderación): la dirección del sitio que quieres agregar. 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 Maps.
  • language: el idioma en el que se informa el nombre del sitio. Consulta la lista de idiomas admitidos y sus códigos. Ten en cuenta que, a menudo, actualizamos los idiomas admitidos, por lo que es posible que esta lista no esté completa.
  • location (obligatorio): la ubicación geográfica, especificada mediante valores de latitud y longitud, del sitio que deseas agregar.
  • name (obligatorio): el nombre completo del sitio. 255 caracteres como máximo.
  • phone_number (recomendado para aumentar las posibilidades de aprobar la moderación): el número de teléfono asociado con el sitio. 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 Maps. Este número debe indicarse en formato local o internacional:
    • El formato local puede diferir según el país. Consulta el artículo de Wikipedia. Por ejemplo, el número de teléfono local de la oficina de Google en Sídney, Australia, es (02) 9374 4000.
    • 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 Sídney, Australia, es +61 2 9374 4000.
  • types (obligatorio): la categoría a la que pertenece el sitio. Si bien types admite un conjunto de opciones, actualmente solo se puede especificar un tipo para un sitio. Las solicitudes XML requieren un solo elemento <type>. Consulta la lista de tipos admitidos para obtener más información. Si ninguno de los tipos admitidos coincide con este sitio, puedes especificar other.
  • website (recomendado para aumentar las posibilidades de aprobar la moderación): una dirección URL que conduce al sitio web autorizado del sitio, como la página de inicio de una empresa. Si un sitio posee una dirección de sitio web 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 Maps.

Respuestas de agregado de sitios

Las respuestas de agregado de sitios se devuelven en el formato indicado por el parámetro output en la ruta de acceso de la dirección URL de la solicitud.

La API devuelve un código de estado y, si la solicitud fue exitosa, la respuesta incluirá las siguientes propiedades para el nuevo sitio:

  • place_id: un identificador textual que identifica de forma exclusiva un sitio. Para recuperar información sobre el sitio, pasa este identificador en el campo placeid de una solicitud de detalles del sitio. Para obtener más información sobre los id. de sitio, consulta la información general sobre id. de sitio.
  • scope: indica el ámbito de place_id. Los posibles valores para este campo son los siguientes:
    • APP: solo tu aplicación reconoce el id. de sitio. Nota: Las respuestas de agregado de sitios siempre estarán limitadas al ámbito de la APP, ya que el sitio aún no aprobó el proceso de moderación.
    • GOOGLE: el id. de sitio está disponible para otras aplicaciones y en Google Maps. Como se indicó anteriormente, las respuestas de agregado de sitios nunca tendrán un alcance de la totalidad de Google.
  • reference: un token único que puedes usar para recuperar información adicional acerca del sitio. Nota: reference ha quedado en desuso en favor de place_id. Consulta el aviso sobre desuso en esta página.
  • id: un identificador estable y único que designa este sitio. No se puede usar este identificador para recuperar información sobre el sitio, pero se garantiza que es válido en todas las sesiones. Se puede usar para consolidar datos acerca del sitio y para verificar la identidad de un sitio entre búsquedas independientes. Nota: id ha quedado en desuso en favor de place_id. Consulta el aviso sobre desuso en esta página.
{
  "status": "OK",
  "place_id": "CdIJN2t_tDeuEmsRUsoyG83frY4",
  "scope": "APP",
  "reference": "CiQgAAAAeTQS1RtzAyVRVjHcRiIWmWeqcAl3k7bluW7GINLDULESEHozTQhy6OHJw03ziDvY1uEaFAP_vDRhK-UbWw3Gd7Ulqm3eRjIs",
  "id": "6947fc4007436a71dbda51ef9a58627c8e8858f9"
}

Elimina un sitio

Un sitio solo se podrá eliminar si:

  • El sitio fue agregado por la aplicación que solicita que se elimine.
  • La solicitud de agregado de sitios no aprobó el proceso de moderación de Google Maps y, por lo tanto, dicho sitio solo está visible para la aplicación que lo agregó.

Si intentas eliminar un sitio que no cumple con estos criterios, la API devolverá un código de estado REQUEST_DENIED.

Una solicitud de eliminación de sitios es una solicitud HTTP POST como la siguiente:


JSON
POST https://maps.googleapis.com/maps/api/place/delete/json?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

{
  "place_id": "place ID"
}
      
XML
POST https://maps.googleapis.com/maps/api/place/delete/xml?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

<PlaceDeleteRequest>
  <place_id>place ID</place_id>
</PlaceDeleteRequest>
      

Ten en cuenta que la ruta de acceso de la dirección URL indica el formato de entrada y salida:

  • json (recomendado) indica el formato de entrada y salida en JavaScript Object Notation (JSON).
  • xml indica el formato de entrada y salida como XML.

La dirección URL debe contener el siguiente parámetro:

  • key: la clave de API de tu aplicación. Esta clave identifica tu aplicación a los fines de la administración de la cuota, de modo que los sitios agregados desde tu aplicación estén inmediatamente disponibles en ella. Para obtener más información, consulta Obtener una clave.

El cuerpo de la solicitud se debe estructurar de acuerdo con el parámetro output especificado (JSON o XML). Debe incluir uno de los dos campos que se indican a continuación:

  • place_id: una cadena que identifica el sitio que se debe eliminar, obtenida a partir de una búsqueda de sitios. Para obtener más información sobre los id. de sitio, consulta la información general sobre id. de sitio.
  • También puedes especificar un valor reference para identificar el sitio. Ten en cuenta que reference ha quedado en desuso en favor de place_id. Consulta el aviso sobre desuso en esta página.

Respuestas de eliminación de sitios

Las respuestas de eliminación de sitios se proporcionan en el formato indicado por el parámetro output en la ruta de acceso de la dirección URL de la solicitud.

Una solicitud de eliminación exitosa devuelve el siguiente código de estado:

{
  "status": "OK"
}

Códigos de estado

Los códigos de estado para las solicitudes de agregado o eliminación de sitios son los siguientes:

  • OK indica que no se produjeron errores y que el sitio se agregó o eliminó satisfactoriamente.
  • UNKNOWN_ERROR indica un error del servidor; puedes tener éxito al intentarlo nuevamente.
  • OVER_QUERY_LIMIT indica que has excedido tu cuota.
  • REQUEST_DENIED indica que se rechazó tu solicitud. Esto podría deberse a que has intentado eliminar un sitio agregado por otra aplicación o que ya aprobó el proceso de moderación de Google Maps.
  • INVALID_REQUEST generalmente indica que faltan parámetros en la solicitud. También obtendrás este código de estado si intentas agregar un sitio cuyo name supera los 255 caracteres.
  • NOT_FOUND puede devolverse para solicitudes de eliminación de sitios e indica que la referencia proporcionada para un sitio no se pudo resolver.

Mensajes de error

Cuando Google Places API Web Service devuelve un código de estado diferente de OK, 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 proporcionado.

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…