google-maps/
place-details

Recopile detalles de URL públicas conocidas de Google Maps y obtenga campos normalizados de identidad del lugar, categoría, dirección, contacto, calificación, cantidad de reseñas, sitio web y datos geográficos.

Google Maps Place Details API

URL de Maps conocidas
Detalles del lugar
Ubicaciones normalizadas
0.15 créditos por resultado
Listo
Listo

Ingrese los parámetros y envíe una solicitud. El estado de la tarea y los resultados normalizados aparecerán aquí.

README

Por SocQ · Actualizado el

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ámetrosObligatorioDescripción
urlsObligatorioLista 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.

  1. 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.
  2. Envíe urls por POST a /v1/google-maps/place-details y guarde el task_id devuelto.
  3. Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle.
  4. 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 true

Casos 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.

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

Explorar otras plataformas

Combine los datos de Google Maps con datos públicos de otras plataformas sociales compatibles.

Google Maps Place Details API — FAQ

Google Maps Place Details API convierte URL públicas conocidas de Google Maps en registros PlaceItem normalizados. Devuelve los campos disponibles de identidad, categoría, contacto, calificación, cantidad de reseñas, dirección, sitio web y ubicación.

Envíe referencias cuyo nombre de host analizado sea google.com, goo.gl o un subdominio de cualquiera de los dos. Se acepta cualquier esquema cuando hay una autoridad y un nombre de host, también se aceptan referencias relativas al protocolo y no se exige una ruta /maps/place específica.

No. La solicitud acepta URL públicas conocidas de Google Maps a través de SocQ y no acepta un Place ID oficial, una clave de API de Google, una credencial OAuth ni una máscara de campos.

No. La entrada del proveedor contiene una fila de detalle por cada URL no vacía y un límite interno igual a esa cantidad de filas; results_limit no es un campo público de la solicitud.

Una URL de origen puede no estar disponible, devolver una fila con error o no producir un lugar normalizado utilizable. Las demás URL enviadas continúan de forma independiente.

Consulte GET /v1/tasks/{task_id}, lea data.results.items tras el éxito y solicite la siguiente página con next_cursor mientras has_more sea true.

La estimación es de 0.15 créditos de SocQ por cada URL no vacía enviada. La facturación final es de 0.15 créditos por cada registro de lugar estándar devuelto con éxito, y un conjunto de resultados vacío cuesta cero créditos.