Google Maps Search — Referencia de API

POST

Disponible

/google/maps/search

Maps Search

Busca lugares de Google Maps por consulta y ubicación. Usa el endpoint de detalles para un lugar identificado.

type

maps_search

result

places

Facturacion

2 credits

Busca lugares de Google Maps por consulta y ubicación. Usa el endpoint de detalles para un lugar identificado.

Parametros

CampoTipoDisponibilidadDescripcion

q

requerido

string

requerido

Texto de busqueda.

hl

opcional

string

opcional

Codigo de idioma. Predeterminado: en.

gl

opcional

string

opcional

Codigo de pais. Predeterminado: us.

page

opcional

number

opcional

Numero de pagina desde 1. Predeterminado: 1.

lat

opcional

number

opcional

Latitud del centro del mapa. Debe enviarse con lng.

lng

opcional

number

opcional

Longitud del centro del mapa. Debe enviarse con lat.

zoom

opcional

number

opcional

Zoom del mapa de 1 a 21. Predeterminado: 14 con coordenadas.

location

ejemplo

object

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: {"location_query":"Seattle, WA"}

query

ejemplo

string

Ejemplo del catálogo; la API valida campos obligatorios.

ejemplo: "coffee"

json

{
  "location": {
    "location_query": "Seattle, WA"
  },
  "query": "coffee"
}

Abrir en Playground

Campos de respuesta

CampoTipoDisponibilidadDescripcion

query

requerido

string

requerido

Consulta normalizada de la solicitud.

page

requerido

number

requerido

Numero de pagina actual desde 1.

places

opcional

MapsPlace[]

Cuando se analizan lugares locales.

Resultados de lugares locales.

MapsPlace Schema de item

CampoTipoDisponibilidadDescripcion

position

opcional

number

Solo Maps Search.

Posición del lugar en resultados locales.

name

requerido

string

requerido

Nombre del lugar.

title

requerido

string

requerido

Alias de name.

feature_id

requerido

string

requerido

ID de elemento de Google Maps.

place_id

opcional

string

Cuando Google lo expone.

ID de lugar de Google.

data_id

opcional

string

Alias de feature_id.

ID de datos de Maps.

cid

opcional

string

Derivado de feature_id si es posible.

CID de Google.

kgmid

opcional

string

Cuando existe en datos de Maps.

ID de máquina del gráfico de conocimiento.

google_maps_url

opcional

string

Cuando Google expone una URL de Maps.

URL de Google Maps.

url

opcional

string

google_maps_url o website como alternativa.

URL principal del lugar.

rating

opcional

number

Cuando hay puntuación.

Puntuación de Google.

types

opcional

string[]

Cuando hay categorías.

Etiquetas de tipo de lugar.

category

opcional

object

Cuando se analiza la categoría.

Datos estructurados de categoría.

address

opcional

string

Cuando hay dirección.

Dirección formateada.

address_components

opcional

object

Cuando hay componentes.

Calle, ciudad, código postal y país.

plus_code

opcional

object

Cuando hay Plus Code.

Plus Codes globales y compuestos.

phone

opcional

string

Cuando hay teléfono.

Número local.

phone_international

opcional

string

Cuando existe.

Número internacional.

phone_uri

opcional

string

Cuando existe.

URI de teléfono.

website

opcional

string

Cuando hay sitio web.

Sitio web del negocio.

website_domain

opcional

string

Cuando hay dominio web.

Dominio web del negocio.

latitude

opcional

number

Cuando hay coordenadas.

Latitud.

longitude

opcional

number

Cuando hay coordenadas.

Longitud.

image

opcional

string

Cuando hay imagen.

Imagen principal del lugar.

thumbnail

opcional

string

Alias de image, si existe.

Alias de imagen principal.

photos

opcional

MapsPhoto[]

Cuando se analizan fotos.

ID, URL, tamaño y coordenadas opcionales de foto.

hours

opcional

Record<string,string>

Cuando se analizan horarios.

Horario por día.

open_status

opcional

object

Cuando hay estado.

Estado de apertura y horario actual.

attributes

opcional

object[]

Cuando se analizan atributos.

Atributos agrupados del lugar.

related_places

opcional

object[]

Cuando hay lugares relacionados.

Lugares relacionados de Maps.

short_description

opcional

string

Cuando hay descripción.

Descripción breve del lugar.

description

opcional

string

Cuando hay descripción.

Descripción extensa del lugar.

snippet

opcional

string

short_description o description como alternativa.

Resumen normalizado.

timezone

opcional

string

Cuando existe.

Zona horaria del lugar.

region

opcional

string

Cuando existe.

Etiqueta de región.

country_code

opcional

string

Cuando existe.

Código de país.

language

opcional

string

Cuando existe.

Código de idioma de Maps.

Ejemplos de código y respuesta

bash

curl -X POST 'https://api.serpbase.dev/google/maps/search' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"location":{"location_query":"Seattle, WA"},"query":"coffee"}'

Ejemplo existente de Google

bash

curl -X POST https://api.serpbase.dev/google/maps/search \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "q": "coffee",
    "hl": "en",
    "gl": "us",
    "page": 1,
    "lat": 37.7749,
    "lng": -122.4194,
    "zoom": 14
  }'

Notas

Descubrimiento local, tiendas y auditorias geo.

Envía lat y lng juntos. zoom solo es válido con coordenadas y su valor predeterminado es 14.