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
4.4(2,937)·Coffee shop
{"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}
Precios y proveedores
Precios del endpoint Lugar de la API de Google Maps: una API, 4 proveedores intercambiables
El proveedor más barato responde primero. Si falla, el siguiente toma el relevo en la misma llamada.
con un tope de US$0.0099 por solicitud1 resultadoUS$0.00882 resultadostope de US$0.0099Se te cobra por lo que se devuelve. Baja el límite para pagar menos, y ninguna solicitud puede costar más que el tope, sin importar cuánto se devuelva.
Pruébalo
Obtén Lugar de Google Maps en una sola solicitud
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.
Respuesta
JSON, un valor de ejemplo por campo.
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.
- 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.
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.