Preguntas frecuentes

Respuestas breves a las preguntas que más recibimos. Si la tuya no está aquí, pregúntanos.

Primeros pasos

¿Necesito una clave de API o una cuenta para probarlo?

No. Cualquier dirección tiene 2.500 solicitudes al día sin clave y sin cuenta, en todos los endpoints y todos los hosts compatibles. Regístrate (tu nombre, una dirección de correo electrónico y una contraseña) cuando quieras claves propias, un historial de uso, crédito prepago o un paquete Unlimited. Las solicitudes hechas sin clave y las hechas con una clave desde la misma red comparten una sola cuota diaria, así que una cuenta no duplica las 2.500 gratuitas.

¿Qué necesito para registrarme?

Tu nombre, una dirección de correo electrónico y una contraseña. Nada más: ni empresa ni tarjeta. Puedes crear más claves de inmediato y añadir crédito o un paquete cuando lo decidas.

¿Cómo funciona el crédito?

Recargas un saldo por adelantado, cualquier importe desde 5 €, con tarjeta o en criptomonedas. Cada solicitud por encima de las 2.500 gratuitas del día de una clave descuenta 0,0001 € de él. El crédito lo comparten todas tus claves de pago por uso, nunca caduca y no se cobra nada automáticamente. Cuando se agota, las solicitudes por encima de la cuota gratuita se rechazan con 402 hasta que recargues.

¿Cómo se paga?

Con tarjeta a través de Polar, o en criptomonedas a través de NOWPayments: Bitcoin, Ethereum, USDT, USDC, Litecoin y muchas más. El importe se fija al pagar y se aplica en cuanto se confirma el pago. Todos los precios están en euros.

¿Qué incluye el paquete Unlimited?

Una clave sin cargos por solicitud en todos los endpoints y todos los hosts compatibles, por 50 € al mes, que puede usarse desde hasta tres direcciones IP por cada 24 horas móviles. Cada paquete tiene su propia clave; contrata varios si tienes varias aplicaciones. Consulta los precios.

¿Hay un programa de referidos?

Sí. Tu panel tiene un enlace de referido; el 10 % de cada factura pagada por alguien que se registró a través de él va a un saldo de referidos separado de tu crédito. Pásalo a crédito cuando quieras, o retíralo en criptomonedas a partir de 20 €. Los retiros se procesan a mano y el id de la transacción aparece en tu panel.

¿Hay códigos de cupón?

A veces: descuentos porcentuales o fijos en una recarga o un paquete, o crédito extra. Introduce el código al crear la factura o en cualquier factura sin pagar antes de pagarla.

Acceso y límites

¿Cómo se cuenta la cuota gratuita?

Por clave y por día UTC, en todos los endpoints y hosts compatibles. Las consultas de IP por lotes y las llamadas de elevación con varios puntos cuentan una por elemento. Las solicitudes rechazadas y los errores del servidor nunca se contabilizan.

¿Qué significa el límite de IP?

Las primeras direcciones que usan una clave ocupan cada una un espacio durante 24 horas desde su primera solicitud. Una clave de pago por uso tiene dos espacios, una clave Unlimited tres. Cuando terminan las 24 horas de un espacio, se libera solo; así, si dos servidores usaron la clave a las 02:00 y un tercero a las 04:00, dos espacios vuelven a estar libres a las 02:00 del día siguiente y el tercero a las 04:00. Una solicitud desde una dirección nueva mientras todos los espacios están ocupados se rechaza con HTTP 403 y el código key_ip_limit; la respuesta indica cuándo se libera el siguiente espacio. Para más máquinas, crea más claves o añade más paquetes.

¿Puedo llamar a la API desde un navegador o una app móvil?

CORS está habilitado, pero una clave en el código del cliente es visible para todo el mundo y alcanzaría su límite de IP tras un par de visitantes. Llama a la API desde tu propio servidor y pon la clave allí. Lo mismo vale para los reemplazos compatibles de mapas en JavaScript: las teselas y las cargas de bibliotecas no necesitan clave, pero las llamadas de geocodificación deben pasar por tu servidor.

¿Hay algún límite de frecuencia además de la cuota diaria?

Hoy no hay uno fijo. El tráfico que parezca un bucle descontrolado o un ataque puede ralentizarse, y te avisaremos si alguna vez le ocurre a una de tus claves. Los endpoints por lotes existen para que no necesites cientos de solicitudes por segundo.

¿Qué pasa si mi clave se filtra?

Revócala en el panel y crea una nueva. Por el límite de IP, una clave filtrada no puede usarse desde más de dos o tres máquinas al día en ningún caso, y como el crédito es prepago, nadie puede generar una factura mayor que el saldo que decidiste cargar.

Datos y precisión

¿Qué significa el campo precision?

Te dice qué representa el punto devuelto: house para el edificio o la parcela, street para una posición interpolada a lo largo de la calle, postcode para el centro de una zona de código postal, y admin para el centro de una ciudad, distrito, región o país. Si pediste un número de casa y obtuviste postcode, no pudimos encontrar la casa.

¿Qué países tienen datos a nivel de número de casa?

La página de cobertura indica el mejor nivel disponible para cada uno de los 249 países y territorios, con filtros por región y nivel. Se actualiza con cada publicación de datos.

¿Qué fuentes de datos se usan?

Datos oficiales de direcciones y códigos postales, datos de registro y enrutamiento de internet para las consultas de IP, la base de datos estándar de zonas horarias y modelos globales del terreno, además de nuestras propias correcciones. Cada fuente se contrasta con las demás antes de incorporarse, y nada se extrae de otros servicios de geocodificación.

¿Puedo guardar o almacenar en caché los resultados?

Sí. Los resultados son tuyos para guardarlos en tu base de datos, almacenarlos en caché y mostrarlos en cualquier mapa, incluidos mapas de otros proveedores. La única restricción de los términos es revender los datos en bruto como un servicio de geocodificación propio.

¿Con qué frecuencia se actualizan los datos?

Los datos de direcciones se actualizan cada mes, los de IP cada semana, las reglas de zona horaria cada vez que IANA publica una versión, y los datos de elevación cuando aparece un modelo público mejor.

¿Se admiten otros idiomas además del inglés?

Pasa lang con un código ISO 639-1 y los nombres de lugares se devuelven en ese idioma cuando los tenemos, o en el nombre local si no. El formato de las direcciones sigue las convenciones del país en el que está la dirección.

Compatibilidad

¿Los hosts compatibles son copias exactas de las API originales?

Las rutas, los parámetros y las estructuras de respuesta coinciden con la documentación pública de cada proveedor, para que el código cliente existente analice las respuestas sin cambios. Los datos son nuestros, así que los valores difieren, y no se incluyen algunas funciones específicas de cada proveedor. Cada página de compatibilidad indica las diferencias.

¿El reemplazo compatible de Google Maps JavaScript muestra las teselas de mapa de Google?

No. El cargador de gapi.mygeocode.com proporciona el espacio de nombres google.maps con nuestras propias teselas de mapa, geocodificador, autocompletado y servicio de elevación detrás. Street View, Directions y Places Details no están incluidos. Las cargas de mapas no cuentan para tu cuota. Consulta los reemplazos compatibles en JavaScript.

¿My Geocode está afiliado a Google, Microsoft, HERE o Mapbox?

No. Esos nombres pertenecen a sus propietarios y aquí solo se usan para indicar en qué formatos podemos responder.

Soporte

¿Hay una garantía de disponibilidad?

Los planes de autoservicio no incluyen un SLA contractual. Ejecutamos la API en más de una región y mostramos el estado en tiempo real en status.mygeocode.com. Si necesitas un SLA por escrito, habla con nosotros.

¿Cómo obtengo soporte?

Escribe a support@mygeocode.com. Las cuentas de pago reciben respuesta en un día hábil. Las preguntas desde claves gratuitas también se responden, según el tiempo disponible.