Google Maps Place Details
Las páginas públicas de lugares de Google Maps pueden exponer nombres, categorías, descripciones, direcciones, datos de contacto, calificaciones, cantidades de reseñas, sitios web y contexto geográfico. Los registros normalizados facilitan combinar esos campos visibles con inventarios de ubicaciones, investigación de locales, enriquecimiento de directorios y monitoreo en momentos concretos.
Funcionalidades de la Google Maps Place Details API
- Recopilación de detalles por lotes de URLEnvíe una o más URL conocidas de Google Maps y deje que cada entrada no vacía se convierta en una fila de detalle del proveedor, con un límite interno igual a la cantidad de URL enviadas.
- Registros de lugares establesDevuelve identidad, URL de origen, nombre, descripción, categoría, dirección, teléfono, sitio web, calificación y cantidad de reseñas mediante el esquema PlaceItem.
- Contexto geográfico estructuradoMantiene juntos el nombre de la ubicación, la ciudad, la región, el país, la latitud y la longitud disponibles, en lugar de tener que extraerlos del texto de presentación.
- Facturación según resultadosSe estima a 0.15 créditos por URL enviada y se liquida a 0.15 créditos por cada registro de lugar estándar devuelto con éxito; los resultados vacíos no tienen cargo.
Parámetros de la Google Maps Place Details API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria y no vacía de referencias de las que el analizador obtenga un nombre de host. El entorno de ejecución acepta por nombre de host google.com, goo.gl y sus subdominios; acepta cualquier esquema con un componente de autoridad y referencias relativas al protocolo, y no exige un patrón de ruta en particular. |
Cómo usar la Google Maps Place Details API
Envíe URL conocidas de Google Maps, siga la tarea asíncrona y lea todos los PlaceItem guardados mediante el contenedor de resultados estándar con cursor.
- Prepare una o más referencias cuyo nombre de host analizado sea google.com, goo.gl o un subdominio de cualquiera de los dos hosts aceptados.
- Envíe urls por POST a /v1/google-maps/place-details y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
- Lea data.results.items y siga next_cursor mientras has_more sea true; la solicitud de envío no tiene un campo results_limit.
curl -X POST "https://api.socq.ai/v1/google-maps/place-details" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://www.google.com/maps/place/Coffee%20Project%20New%20York%20%7C%20East%20Village/data=!4m7!3m6!1s0x89c2599b5a24d7fd:0x9e354f6cf514b9fc!8m2!3d40.7270884!4d-73.9893820!16s%2Fg%2F11c3svpqld!19sChIJ_dckWptZwokR_LkU9WxPNZ4?authuser=0&hl=en&rclk=1"]}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueCasos de uso de la Google Maps Place Details API
- Enriquecimiento de directorios de ubicaciones: Agregue campos normalizados de categoría, dirección, teléfono, sitio web, calificación, cantidad de reseñas y coordenadas a URL de lugares conocidas.
- Auditorías de locales y sucursales: Vuelva a consultar una lista controlada de URL para comparar los valores visibles de identidad, contacto, calificación y datos geográficos en momentos de recopilación definidos.
- Conciliación de registros de lugares: Use los ID, las URL de origen, los nombres, las direcciones y las coordenadas devueltos para relacionar lugares públicos con registros internos de ubicaciones.
Consejos de expertos para la Google Maps Place Details API
- Envíe URL de Maps absolutas y completas para que el analizador pueda resolver un nombre de host aceptado; los nombres de host sin esquema no producen un nombre de host en el analizador del entorno de ejecución.
- No agregue Place ID, claves de API de Google, máscaras de campos ni results_limit, porque no son campos de este contrato de solicitud de SocQ.
- Trate cada URL enviada como un candidato de detalle y no como un resultado garantizado; las filas de la fuente no disponibles o inutilizables pueden dejar menos elementos que URL.
- Conserve como nulos los miembros de teléfono, sitio web, calificación, cantidad de reseñas, descripción, momento de publicación y ubicación, en lugar de inventar valores de reemplazo.
- Continúe con next_cursor siempre que has_more sea true, porque la paginación se aplica al leer los resultados guardados de la tarea, aunque el límite del proveedor provenga de la cantidad de URL.
APIs relacionadas
Además de la Google Maps Place Details API, use estas APIs cuando necesite otro tipo de datos públicos de Google Maps.
- Google Maps Search API — Busca lugares públicos de Google Maps por consulta y ubicación, con campos normalizados de identidad, dirección, contacto, calificación, cantidad de reseñas, URL y coordenadas.
- Google Maps Reviews API