Find Place (heredado)

Una solicitud de Find Place (heredada) toma una entrada de texto y devuelve un lugar. La entrada puede ser cualquier tipo de dato de texto de Places, como un nombre, una dirección o un número de teléfono. La solicitud debe ser una cadena. Una solicitud de Find Place (heredada) que use datos que no sean de cadena, como una coordenada de latitud/longitud o un Plus Code, generará un error.

Solicitudes de Find Place (heredada)

Una solicitud de Find Place (heredada) es una URL HTTP con el siguiente formato:

https://maps.googleapis.com/maps/api/place/findplacefromtext/output?parameters

donde output puede ser cualquiera de los siguientes valores:

• json (recomendado) indica el resultado en notación de objeto de JavaScript (JSON).
• xml indica que el resultado es XML.

Se requieren ciertos parámetros para iniciar una solicitud de Find Place (heredada). Tal como es práctica estándar para las URLs, todos los parámetros se separan usando el signo et (&).

Parámetros obligatorios

• entrada

  Es la cadena de texto en la que se realizará la búsqueda. Debe ser el nombre de un lugar, una dirección o un número de teléfono (por ejemplo, "123 Main Street" o "Municipalidad").

• inputtype

  Es el tipo de entrada. Puede ser textquery o phonenumber. Los números de teléfono deben estar en formato internacional (precedidos por un signo más ("+"), seguido del código de país y, luego, el número en sí). Consulta la recomendación E.164 de ITU para obtener más información.

Parámetros opcionales

• campos

  Precaución: Las solicitudes de Place Search (heredada) y Place Details (heredada) no devuelven los mismos campos. Las solicitudes de Place Search (heredada) devuelven un subconjunto de los campos que devuelven las solicitudes de Place Details (heredada). Si Place Search (heredada) no devuelve el campo que deseas, puedes usar esta función para obtener un place_id y, luego, usar ese ID de lugar para realizar una solicitud de Place Details (heredada). Para obtener más información sobre los campos que no están disponibles en una solicitud de Place Search (heredada), consulta Compatibilidad con campos de la API de Places.

  Usa el parámetro fields para especificar una lista separada por comas de los tipos de datos de lugar que deseas que se muestren. Por ejemplo: fields=formatted_address,name,geometry. Usa una barra diagonal para especificar valores compuestos. Por ejemplo: opening_hours/open_now.

  Los campos se dividen en tres categorías de facturación: Basic, Contact y Atmosphere. Los campos de datos básicos se facturan con la tarifa base, y los campos de datos de contacto y atmosféricos se facturan con una tarifa más alta. Los SKU de Basic, Contact y Atmosphere se cobran además del SKU base (Place Details, Find Place, Nearby Search o Text Search) de la solicitud que los activó. Para obtener más información, consulta la hoja de precios.

  Básica

  La categoría Basic incluye los siguientes campos: address_components, adr_address, business_status, formatted_address, geometry, icon, icon_mask_base_uri, icon_background_color, name, permanently_closed (obsoleto), photo, place_id, plus_code, type, url, utc_offset, vicinity, wheelchair_accessible_entrance.

  Contacto

  La categoría Contact incluye los siguientes campos: current_opening_hours, formatted_phone_number, international_phone_number, opening_hours, secondary_opening_hours y website.

  Atmosphere

  La categoría Atmosphere incluye los siguientes campos: curbside_pickup, delivery, dine_in, editorial_summary, price_level, rating, reservable, reviews, serves_beer, serves_breakfast, serves_brunch, serves_dinner, serves_lunch, serves_vegetarian_food, serves_wine, takeout y user_ratings_total.

  Nota: Las atribuciones, html_attributions, se devuelven siempre con todas las llamadas, independientemente de si se solicitó el campo.

• idioma

  Es el idioma en el que se devolverán los resultados.

  • Consulta la lista de idiomas disponibles. Google suele actualizar los idiomas admitidos, por lo que es posible que esta lista no sea exhaustiva.
  • Si no se proporciona language, la API intenta usar el idioma preferido, como se especifica en el encabezado Accept-Language.
  • La API hace todo lo posible para proporcionar una dirección que sea legible tanto para el usuario como para los locales. Para lograr ese objetivo, devuelve direcciones en el idioma local, transliteradas a una escritura legible por el usuario si es necesario, respetando el idioma preferido. Todas las demás direcciones se devuelven en el idioma preferido. Todos los componentes de la dirección se devuelven en el mismo idioma, que se elige a partir del primer componente.
  • Si un nombre no está disponible en el idioma preferido, la API usa la coincidencia más cercana.
  • El idioma preferido tiene una pequeña influencia en el conjunto de resultados que la API elige mostrar y en el orden en que se muestran. El geocodificador interpreta las abreviaturas de manera diferente según el idioma, como las abreviaturas de los tipos de calles o los sinónimos que pueden ser válidos en un idioma, pero no en otro. Por ejemplo, utca y tér son sinónimos de calle en húngaro.

• locationbias

  Prioriza los resultados en un área determinada especificando un radio más una latitud y longitud, o bien dos pares de latitud y longitud que representen los puntos de un rectángulo. Si no se especifica este parámetro, la API usa la preferencia de dirección IP de forma predeterminada.

  • Sesgo de IP: Indica a la API que use el sesgo de direcciones IP. Pasa la cadena ipbias (esta opción no tiene parámetros adicionales).
  • Circular: Es una cadena que especifica el radio en metros, además de la latitud y la longitud en grados decimales. Usa el siguiente formato: circle:radius@lat,lng.
  • Rectangular: Es una cadena que especifica dos pares de latitud y longitud en grados decimales, que representan los puntos sur/oeste y norte/este de un rectángulo. Usa el siguiente formato:rectangle:south,west|north,east. Ten en cuenta que los valores este/oeste se ajustan al rango de -180 a 180, y los valores norte/sur se restringen al rango de -90 a 90.

Ejemplos de Find Place (heredado)

En el siguiente ejemplo, se muestra una solicitud de Find Place (heredada) para "Museum of Contemporary Art Australia", que incluye los campos photos, formatted_address, name, rating, opening_hours y geometry:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Museum%20of%20Contemporary%20Art%20Australia
    &inputtype=textquery
    &key=YOUR_API_KEY

En el siguiente ejemplo, se muestra una solicitud de Find Place (heredada) para "Mongolian Grill", en la que se usa el parámetro locationbias para dar preferencia a los resultados que se encuentran en un radio de 2,000 metros de las coordenadas especificadas:

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Mongolian%20Grill&inputtype=textquery&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&locationbias=circle:2000@−33.866,151.216&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=Mongolian%20Grill
    &inputtype=textquery
    &locationbias=circle:2000@−33.866,151.216
    &key=YOUR_API_KEY

En el siguiente ejemplo, se muestra una solicitud de Find Place (heredada) para un número de teléfono. Ten en cuenta que el prefijo de llamada internacional "+" se codificó como %2B para que esta solicitud sea una URL que cumpla con los requisitos. Si se deja sin codificar, el prefijo + se decodificará como un espacio en el servidor, lo que dará como resultado una búsqueda de número de teléfono no válida.

curl -L -X GET 'https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=%2B16502530000&inputtype=phonenumber&fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry&key=YOUR_API_KEY'

https://maps.googleapis.com/maps/api/place/findplacefromtext/json
    ?fields=formatted_address%2Cname%2Crating%2Copening_hours%2Cgeometry
    &input=%2B16502530000
    &inputtype=phonenumber
    &key=YOUR_API_KEY

Respuestas de Find Place (heredado)

Una respuesta de Find Place (heredado) contiene solo los tipos de datos que se especificaron con el parámetro fields, además de html_attributions. En el siguiente ejemplo, se muestra la respuesta a una solicitud de Find Place (heredada) para "Museum of Contemporary Art Australia", que incluye los campos formatted_address, geometry, name, opening_hours, photos y rating.

{
  "candidates":
    [
      {
        "formatted_address": "140 George St, The Rocks NSW 2000, Australia",
        "geometry":
          {
            "location": { "lat": -33.8599358, "lng": 151.2090295 },
            "viewport":
              {
                "northeast":
                  { "lat": -33.85824377010728, "lng": 151.2104386798927 },
                "southwest":
                  { "lat": -33.86094342989272, "lng": 151.2077390201073 },
              },
          },
        "name": "Museum of Contemporary Art Australia",
        "opening_hours": { "open_now": false },
        "rating": 4.4,
      },
    ],
  "status": "OK",
}    

<?xml version="1.0" encoding="UTF-8"?>
<FindPlaceFromTextResponse>
 <candidates>
  <name>Museum of Contemporary Art Australia</name>
  <formatted_address>140 George St, The Rocks NSW 2000, Australia</formatted_address>
  <geometry>
   <location>
    <lat>-33.8599358</lat>
    <lng>151.2090295</lng>
   </location>
   <viewport>
    <southwest>
     <lat>-33.8609434</lat>
     <lng>151.2077390</lng>
    </southwest>
    <northeast>
     <lat>-33.8582438</lat>
     <lng>151.2104387</lng>
    </northeast>
   </viewport>
  </geometry>
  <rating>4.4</rating>
  <opening_hours>
   <open_now>false</open_now>
  </opening_hours>
 </candidates>
 <status>OK</status>
</FindPlaceFromTextResponse>

    

PlacesFindPlaceFromTextResponse

PlacesSearchStatus

Códigos de estado que devuelve el servicio.

• OK: Indica que la solicitud a la API se realizó correctamente.
• ZERO_RESULTS indica que la búsqueda se realizó correctamente, pero no se devolvieron resultados. Esto puede ocurrir si se pasó un valor latlng en una ubicación remota a la búsqueda.
• INVALID_REQUEST: Indica que la solicitud a la API tenía un formato incorrecto, por lo general, debido a que faltaba un parámetro de consulta obligatorio (location o radius).
• OVER_QUERY_LIMIT que indique cualquiera de las siguientes opciones:
  • Superaste los límites de QPS.
  • No se habilitó la facturación en tu cuenta.
  • Se superó el crédito mensual de USD 200 o un límite de uso autoimpuesto.
  • La forma de pago proporcionada ya no es válida (por ejemplo, una tarjeta de crédito venció).
  Consulta las Preguntas frecuentes sobre Maps para obtener más información sobre cómo resolver este error.
• REQUEST_DENIED: Indica que se rechazó tu solicitud, generalmente por los siguientes motivos:
  • Falta una clave de API en la solicitud.
  • El parámetro key no es válido.
• UNKNOWN_ERROR: Indica un error desconocido.

Lugar

Las respuestas de Place Search devuelven el siguiente subconjunto de los campos de Place. No todos los atributos están disponibles para todos los tipos de lugares. Para recuperar los campos que Place Search no devuelve, como address_components, formatted_phone_number, reviews o website, pasa el place_id devuelto en una solicitud de Place Details (heredada). Para conocer la disponibilidad de los campos y los niveles de precios en los extremos, consulta Campos de datos de Place (heredados).