Un enlace de Google Maps. Datos que puedes guardar.
Recibe un enlace compartido, extrae sus coordenadas y conserva el nombre del lugar seleccionado sin desplazar el pin a otro punto cercano.
Crea tu API keycurl "https://maps-api.nexode.app/v1/resolve" \
-H "X-API-Key: TU_API_KEY" \
-H "Content-Type: application/json" \
-d '{"url":"https://www.google.com/maps?q=-12.0453,-77.0309","includeAddress":false}'Permiso de la clave: resolve. Cada petición admitida consume una unidad del plan.
Conserva la ubicación que compartieron
Una persona puede compartir un lugar, un pin o un enlace corto de Google Maps. Mapora interpreta los formatos compatibles y expande los enlaces cortos permitidos para obtener una ubicación utilizable. La respuesta conserva el nombre seleccionado cuando está disponible, latitude, longitude, googleMapsLink y resolved_url. No todos los enlaces de Google Maps contienen un punto resoluble: un resultado válido depende del formato y de los datos que incluya el enlace.
Cuándo consultar una dirección
includeAddress es true por defecto. Cuando está activado, Mapora intenta añadir una referencia de dirección desde Photon/OpenStreetMap. Esa referencia puede corresponder a un lugar cercano y no sustituye las coordenadas del pin original. Si tu flujo solo necesita el nombre y el punto, envía includeAddress:false para omitir esta consulta de dirección. La latencia depende del enlace, la caché y los proveedores; no hay un tiempo de respuesta garantizado.
Cómo tratar una dirección no disponible
Si se consigue el punto pero falla la consulta de dirección, el flujo de resolución puede conservar las coordenadas con addressStatus: unavailable. Cuando se omite la consulta, el estado es not_requested. No descartes un punto válido solo porque no hay una dirección descriptiva y tampoco presentes la referencia como una dirección verificada. Guarda por separado el enlace, el nombre, las coordenadas y el estado de resolución.
Alcance de la integración
El endpoint interpreta enlaces de Google Maps; no consulta Google Places, reseñas, horarios, fotos ni fichas comerciales. Utiliza únicamente los dominios y formatos admitidos: no funciona como un descargador de URLs arbitrarias. Una vez resuelto el punto, puedes insertarlo en un mapa de Mapora o guardarlo en tu aplicación junto con los datos que necesita tu flujo.
Autenticación, cuotas y errores
Envía la clave en X-API-Key o Authorization: Bearer. HTTP 401 indica una clave ausente o inválida; 403, falta de permiso o cuenta suspendida; 429, cuota o velocidad excedida. Consulta las cabeceras de cuota y respeta Retry-After. El panel muestra tu plan y consumo real.