Google Maps Place Detail — Referência da API

POST

Disponível

/google/maps/detail

Maps Detail

Consulte um lugar do Google Maps por ID. Complementa a busca e tem seu próprio preço por solicitação.

type

maps_detail

result

place

Cobranca

3 credits

Consulte um lugar do Google Maps por ID. Complementa a busca e tem seu próprio preço por solicitação.

Parametros

CampoTipoDisponibilidadeDescricao

feature_id

obrigatorio

string

obrigatorio

Use o campo feature_id retornado pelos resultados de local do Maps Search. O formato e 0x...:0x....

hl

opcional

string

opcional

Codigo de idioma. Padrao: en.

gl

opcional

string

opcional

Codigo do pais. Padrao: us.

id

exemplo

string

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

exemplo: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json

{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}

Abrir no Playground

Campos da resposta

CampoTipoDisponibilidadeDescricao

feature_id

obrigatorio

string

obrigatorio

feature_id resolvido da solicitação de detalhes.

page

obrigatorio

number

obrigatorio

Sempre 1 para detalhes do Maps.

place

opcional

MapsPlace

Quando detalhes do lugar são analisados.

Objeto de detalhes de um lugar.

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/detail' \
  -H "Content-Type: application/json" \
  -H 'X-API-Key: YOUR_API_KEY' \
  -d '{"id":"ChIJVVVVVYxK1EARyQpK5cQqEAA"}'

Exemplo existente do Google

bash

curl -X POST https://api.serpbase.dev/google/maps/detail \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your_api_key" \
  -d '{
    "feature_id": "0x8085809c2c6fdc63:0x4b3f2d70e4f5a123",
    "hl": "en",
    "gl": "us"
  }'

Notas

Enriquecimento de locais, CRM local e detalhes.

Use feature_id do resultado de Maps Search para detalhes. Um feature_id válido mas desconhecido retorna status 1004.