Google Maps Search — Referência da API

POST

Disponível

/google/maps/search

Maps Search

Busque lugares do Google Maps por consulta e localização. Use o endpoint de detalhes para um lugar identificado.

type

maps_search

result

places

Cobranca

2 credits

Busque lugares do Google Maps por consulta e localização. Use o endpoint de detalhes para um lugar identificado.

Parametros

CampoTipoDisponibilidadeDescricao

q

obrigatorio

string

obrigatorio

Texto da busca.

hl

opcional

string

opcional

Codigo de idioma. Padrao: en.

gl

opcional

string

opcional

Codigo do pais. Padrao: us.

page

opcional

number

opcional

Numero da pagina a partir de 1. Padrao: 1.

lat

opcional

number

opcional

Latitude do centro do mapa. Deve ser enviada com lng.

lng

opcional

number

opcional

Longitude do centro do mapa. Deve ser enviada com lat.

zoom

opcional

number

opcional

Zoom do mapa de 1 a 21. Padrao: 14 com coordenadas.

location

exemplo

object

Exemplo do catálogo; a API valida campos obrigatórios.

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

query

exemplo

string

Exemplo do catálogo; a API valida campos obrigatórios.

exemplo: "coffee"

json

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

Abrir no Playground

Campos da resposta

CampoTipoDisponibilidadeDescricao

query

obrigatorio

string

obrigatorio

Consulta normalizada da requisicao.

page

obrigatorio

number

obrigatorio

Numero da pagina atual a partir de 1.

places

opcional

MapsPlace[]

Quando lugares locais são analisados.

Resultados de lugares locais.

MapsPlace Schema do item

CampoTipoDisponibilidadeDescricao

position

opcional

number

Somente Maps Search.

Posição do lugar nos resultados locais.

name

obrigatorio

string

obrigatorio

Nome do lugar.

title

obrigatorio

string

obrigatorio

Alias de name.

feature_id

obrigatorio

string

obrigatorio

ID de elemento do Google Maps.

place_id

opcional

string

Quando Google o expõe.

ID de lugar do Google.

data_id

opcional

string

Alias de feature_id.

ID de dados do Maps.

cid

opcional

string

Derivado de feature_id se possível.

CID do Google.

kgmid

opcional

string

Quando existe nos dados do Maps.

ID de máquina do grafo de conhecimento.

google_maps_url

opcional

string

Quando Google expõe uma URL do Maps.

URL do Google Maps.

url

opcional

string

google_maps_url ou website como alternativa.

URL principal do lugar.

rating

opcional

number

Quando há avaliação.

Avaliação do Google.

types

opcional

string[]

Quando há categorias.

Rótulos de tipo de lugar.

category

opcional

object

Quando a categoria é analisada.

Dados estruturados de categoria.

address

opcional

string

Quando há endereço.

Endereço formatado.

address_components

opcional

object

Quando há componentes.

Rua, cidade, código postal e país.

plus_code

opcional

object

Quando há Plus Code.

Plus Codes globais e compostos.

phone

opcional

string

Quando há telefone.

Número local.

phone_international

opcional

string

Quando existe.

Número internacional.

phone_uri

opcional

string

Quando existe.

URI de telefone.

website

opcional

string

Quando há site.

Site do estabelecimento.

website_domain

opcional

string

Quando há domínio do site.

Domínio do site do estabelecimento.

latitude

opcional

number

Quando há coordenadas.

Latitude.

longitude

opcional

number

Quando há coordenadas.

Longitude.

image

opcional

string

Quando há imagem.

Imagem principal do lugar.

thumbnail

opcional

string

Alias de image, se existir.

Alias da imagem principal.

photos

opcional

MapsPhoto[]

Quando fotos são analisadas.

ID, URL, tamanho e coordenadas opcionais da foto.

hours

opcional

Record<string,string>

Quando horários são analisados.

Horário por dia.

open_status

opcional

object

Quando há status.

Status de abertura e horário atual.

attributes

opcional

object[]

Quando atributos são analisados.

Atributos agrupados do lugar.

related_places

opcional

object[]

Quando há lugares relacionados.

Lugares relacionados do Maps.

short_description

opcional

string

Quando há descrição.

Descrição breve do lugar.

description

opcional

string

Quando há descrição.

Descrição extensa do lugar.

snippet

opcional

string

short_description ou description como alternativa.

Resumo normalizado.

timezone

opcional

string

Quando existe.

Fuso horário do lugar.

region

opcional

string

Quando existe.

Rótulo de região.

country_code

opcional

string

Quando existe.

Código do país.

language

opcional

string

Quando existe.

Código de idioma do Maps.

Exemplos de código e resposta

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"}'

Exemplo existente do 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

Descoberta local, lojas e auditorias geo.

Envie lat e lng juntos. zoom só é válido com coordenadas e o padrão é 14.