API de Google Maps

API de Google Maps: Lugar

Busca un lugar en Google Maps por nombre o consulta de búsqueda (opcionalmente acotado a una ubicación) y obtén el lugar que mejor coincide, con los datos disponibles de dirección, contacto, calificación y coordenadas como JSON normalizado.

US$1.00/1k solic., pagas por solicitud, sin suscripción.

Blue Bottle Coffee - Google Maps
google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo
DirectionsSaveNearbySend to phoneShare

Blue Bottle Coffee

4.4(2,937)·Coffee shop

66 Mint St, San Francisco, CA 94103, USA
Open · Monday 6:30 AM-6:00 PM
+1 415-555-0118
bluebottlecoffee.com
OverviewReviewsAbout
Lo que devolvió la APIitems[0]
{
"name": "Blue Bottle Coffee",
"url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
"placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
"address": "66 Mint St, San Francisco, CA 94103, USA",
"street": "66 Mint St",
"city": "San Francisco",
"state": "California",
"postalCode": "94103",
... 15 campos más
}
Disponibilidad
100.00%
30d · 150,371 llamadas
Solicitudes
150,391
30d · semanal, últimas 12 sem.
Respuesta
2.5s
mediana · 30d

Pruébalo

Obtén Lugar de Google Maps en una sola solicitud

requireFieldsarray
Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.
Abrir en
Respuesta de ejemplo
Las ejecuciones gratis devuelven solo los primeros 3 resultados. Agrega fondos a una clave para obtener la respuesta completa.

Este ejemplo muestra 26 de 27 campos. Ver todos los campos

{
  "found": true,
  "data": {
    "items": [
      {
        "name": "Blue Bottle Coffee",
        "url": "https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "placeId": "ChIJd7DoQL2AhYARW-mNQFPuGZo",
        "address": "66 Mint St, San Francisco, CA 94103, USA",
        "street": "66 Mint St",
        "city": "San Francisco",
        "state": "California",
        "postalCode": "94103",
        "countryCode": "US",
        "neighborhood": "SoMa",
        "phone": "+1 415-555-0118",
        "website": "https://bluebottlecoffee.com",
        "category": "Coffee shop",
        "categories": [
          "Coffee shop",
          "Cafe",
          "Espresso bar"
        ],
        "rating": 4.4,
        "reviewsCount": 2937,
        "latitude": 37.7825,
        "longitude": -122.4058,
        "image": "https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no",
        "priceLevel": "$$",
        "plusCode": "QHGX+59 San Francisco, California",
        "permanentlyClosed": false,
        "hours": [
          {
            "day": "Monday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Tuesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Wednesday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Thursday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Friday",
            "hours": "6:30 AM-6:00 PM"
          },
          {
            "day": "Saturday",
            "hours": "7:00 AM-6:00 PM"
          },
          {
            "day": "Sunday",
            "hours": "7:00 AM-5:00 PM"
          }
        ]
      }
    ]
  }
}

Referencia completa de parámetros y respuesta: cada campo, tipo y ejemplo de este endpoint.

Referencia

Una solicitud, un formato de respuesta.

Cada campo que envías y cada campo que recibes, cada uno con un ejemplo real.

Verificado por última vez el 2026-11-14 · disponibilidad y latencia medidas en 30d

Cuerpo de la solicitud

JSON, enviado por POST a este endpoint.

  • querystring

    Blue Bottle Coffee

    El nombre del negocio o el texto de búsqueda, tal como lo escribirías en la barra de búsqueda de Google Maps (p. ej. Blue Bottle Coffee).

  • categoryFilterWordsarray

    Lista opcional de nombres de categorías de lugares de Google Maps que conservar; la coincidencia se limita a un lugar cuya categoría sea una de ellas. Usa los nombres de categoría en minúsculas tal como aparecen en Google Maps (p. ej. ["coffee shop"]). Omítela para permitir cualquier categoría y mantener el precio más barato; un filtro de categoría enruta a una fuente más cara.

  • languagestring

    Código de idioma de dos letras para los detalles del resultado (p. ej. en).

  • locationstring

    San Francisco, CA

    Ubicación opcional en texto libre para acotar la búsqueda, idealmente ciudad y estado o país (p. ej. San Francisco, CA). Restringe la consulta a la mejor coincidencia en esa zona.

  • placeMinimumStarsenum

    Solo coincide con un lugar con una calificación promedio de al menos: two (2+), twoAndHalf (2.5+), three (3+), threeAndHalf (3.5+), four (4+) o fourAndHalf (4.5+). Se excluyen los lugares sin reseñas. Omite este campo para mantener el precio más barato; una calificación mínima enruta a una fuente más cara.

  • requireFieldsarray

    Optional; omit it and routing is unchanged, with the cheapest source serving. Name the output fields this request must be able to return, for example `plusCode` or `postalCode`, and it is served only by a source that returns every one of them. Fields you do not name are still returned whenever the serving source has them. This can raise your price: when the cheapest source cannot return a named field, a dearer source serves, and you are quoted and charged its price. A named field can still be absent on a place that genuinely lacks it. Naming a combination that no single source returns together is refused as invalid input, with no charge.

  • websiteenum

    Filtra según si el lugar indica un sitio web: allPlaces (predeterminado), withWebsite (solo si tiene sitio web) o withoutWebsite (solo si no tiene). Omite este campo, o envía allPlaces, para mantener el precio más barato; withWebsite y withoutWebsite enrutan a una fuente más cara.

Envías. Un cuerpo JSON pequeño. Los valores que se muestran son ejemplos para reemplazar por los tuyos.

Respuesta

JSON, un valor de ejemplo por campo.

each itemdata.items[]

The best-matching place for the query, with available address, contact, category, rating, opening-hours, and coordinate details. Up to one element (empty when nothing matched). Populated whenever the provider has data for the entity.

  • addressstring

    66 Mint St, San Francisco, CA 94103, USA

    Full formatted street address. Populated whenever the provider has data for the entity.

  • categoriesstring[]

    Every Google Maps category listed for the place.

  • categorystring

    Coffee shop

    Primary Google Maps category (e.g. Coffee shop). Populated whenever the provider has data for the entity.

  • citystringse puede exigir

    San Francisco

  • countryCodestringse puede exigir

    US

    Two-letter country code.

  • hoursobject[]

    Opening hours by day: each element is an object with the day name and its hours.

  • imagestring

    https://lh3.googleusercontent.com/places/ANXAkqHBlueBottleMint=w500-h375-k-no

    URL of the primary place photo.

  • latitudenumber

    37.7825

    Populated whenever the provider has data for the entity.

  • longitudenumber

    -122.4058

    Populated whenever the provider has data for the entity.

  • namestring

    Blue Bottle Coffee

    Business or place name. Populated whenever the provider has data for the entity.

  • neighborhoodstringse puede exigir

    SoMa

  • permanentlyClosedbooleanse puede exigir

    false

    Whether the place is permanently closed.

  • phonestring

    +1 415-555-0118

    Formatted phone number.

  • placeIdstring

    ChIJd7DoQL2AhYARW-mNQFPuGZo

    Google Maps place id. Populated whenever the provider has data for the entity.

  • plusCodestringse puede exigir

    QHGX+59 San Francisco, California

    Google Plus Code for the location.

  • postalCodestringse puede exigir

    94103

  • priceLevelstring

    $$

    Price level indicator (e.g. a price range).

  • ratingnumber

    4.4

    Average star rating.

  • reviewsCountinteger

    2937

    Total number of reviews.

  • statestringse puede exigir

    California

    State or region name.

  • streetstringse puede exigir

    66 Mint St

    Street portion of the address.

  • urlstring

    https://www.google.com/maps/place/?q=place_id:ChIJd7DoQL2AhYARW-mNQFPuGZo

    Google Maps URL for the place. Populated whenever the provider has data for the entity.

  • websitestring

    https://bluebottlecoffee.com

    Business website URL.

top level
  • foundboolean

    true

  • reason"not_found"

    Present only when `found` is false, and says why there is no result. `not_found`: the source states the target does not exist, or returned nothing for it. A `found: false` answer is a successful call, not an error, and `costUsd` is what it actually cost.

Recibes. Campos con nombre y tipo, con el mismo formato sin importar qué fuente responda.

Preguntas frecuentes

Acerca del endpoint Lugar de la API de Google Maps

El endpoint Lugar de AnyAPI para Google Maps devuelve datos de Google Maps como JSON normalizado con una sola llamada POST a /v1/run/maps.place. Busca un lugar en Google Maps por nombre o consulta de búsqueda (opcionalmente acotado a una ubicación) y obtén el lugar que mejor coincide, con los datos disponibles de dirección, contacto, calificación y coordenadas como JSON normalizado. AnyAPI enruta cada solicitud entre 4 fuentes y recurre automáticamente a otra cuando una falla. Cuesta desde US$1 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. En los últimos 30 días, el 100.0% de las llamadas al endpoint Lugar de la API de Google Maps a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.5 segundos en 150.371 llamadas medidas.

Cuesta desde US$1 por cada 1,000 solicitudes, en dólares estadounidenses, sin suscripción y sin mínimo mensual. Agregas fondos a una billetera en dólares y cada llamada descuenta de ella. Algunas solicitudes fallidas pagadas con la billetera generan cargos de procesamiento que trasladamos al costo, sin margen; la respuesta de error muestra el monto cobrado.

Busca un lugar en Google Maps por nombre o consulta de búsqueda (opcionalmente acotado a una ubicación) y obtén el lugar que mejor coincide, con los datos disponibles de dirección, contacto, calificación y coordenadas como JSON normalizado. La respuesta es JSON normalizado con el mismo envoltorio que devuelve cada endpoint de AnyAPI, así que procesar un segundo endpoint es solo cambiar la URL.

En los últimos 30 días, el 100.0% de las llamadas al endpoint Lugar de la API de Google Maps a través de AnyAPI tuvo éxito, con un tiempo de respuesta mediano de 2.5 segundos en 150.371 llamadas medidas. Estas son mediciones propias de AnyAPI sobre el tráfico que pasa por el gateway, recalculadas continuamente, no un objetivo de nivel de servicio publicado.

Sí. Una cuenta nueva de AnyAPI empieza con US$0.10 de saldo gratis, sin tarjeta, que alcanza para 100 llamadas a Lugar de Google Maps a US$0.001 cada una.

AnyAPI consulta la siguiente de sus 4 fuentes en la misma solicitud, empezando por la más barata, así que la caída de una fuente no hace fallar tu llamada.

Envía una solicitud POST a https://api.getanyapi.com/v1/run/maps.place con tu clave de AnyAPI en un encabezado "Authorization: Bearer" y la entrada como cuerpo JSON. La misma clave y la misma billetera sirven para todos los endpoints de AnyAPI.

No. Agregas dólares a un solo saldo prepagado de AnyAPI y cada solicitud descuenta de él. No hay plan mensual ni mínimo, y el mismo saldo paga todos los endpoints de AnyAPI.

Sí. Instala @getanyapi/sdk desde npm para TypeScript o getanyapi desde pip para Python. Ambos llaman a todos los endpoints de AnyAPI con la misma clave, y también sirve cualquier cliente HTTP.

Sí. Un agente puede conectarse al servidor MCP de AnyAPI en https://api.getanyapi.com/mcp, o crear su propia clave de prueba gratis con un solo POST sin autenticar a https://api.getanyapi.com/agent/signup y llamar a este endpoint por HTTP.