Google Maps Place Detail — Referencia de API

POST

Disponible

/google/maps/detail

Maps Detail

Consulta un lugar de Google Maps por ID. Complementa la búsqueda y tiene su propio precio por solicitud.

type

maps_detail

result

place

Facturacion

3 credits

Consulta un lugar de Google Maps por ID. Complementa la búsqueda y tiene su propio precio por solicitud.

Parametros

CampoTipoDisponibilidadDescripcion

feature_id

requerido

string

requerido

Usa el campo feature_id devuelto por los resultados de lugar de Maps Search. Tiene formato 0x...:0x....

hl

opcional

string

opcional

Codigo de idioma. Predeterminado: en.

gl

opcional

string

opcional

Codigo de pais. Predeterminado: us.

id

ejemplo

string

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

ejemplo: "ChIJVVVVVYxK1EARyQpK5cQqEAA"

json

{
  "id": "ChIJVVVVVYxK1EARyQpK5cQqEAA"
}

Abrir en Playground

Campos de respuesta

CampoTipoDisponibilidadDescripcion

feature_id

requerido

string

requerido

feature_id resuelto desde la solicitud de detalles.

page

requerido

number

requerido

Siempre 1 para detalles de Maps.

place

opcional

MapsPlace

Cuando se analizan detalles del lugar.

Objeto de detalles de un lugar.

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

Ejemplo existente de 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

Enriquecimiento de lugares, CRM local y detalles.

Usa feature_id del resultado de Maps Search para detalles. Un feature_id válido pero desconocido devuelve status 1004.