Questions fréquentes
Des réponses courtes aux questions qu'on nous pose le plus souvent. Si la vôtre n'y figure pas, posez-la.
Premiers pas
Ai-je besoin d'une clé d'API ou d'un compte pour l'essayer ?
Non. Toute adresse dispose de 2 500 requêtes par jour sans clé ni compte, sur tous les endpoints et tous les hôtes compatibles. Inscrivez-vous (votre nom, une adresse e-mail et un mot de passe) lorsque vous voulez vos propres clés, un historique d'utilisation, du crédit prépayé ou un forfait Unlimited. Les requêtes faites sans clé et celles faites avec une clé depuis le même réseau partagent un même quota journalier : un compte ne double donc pas les 2 500 requêtes gratuites.
De quoi ai-je besoin pour m'inscrire ?
Votre nom, une adresse e-mail et un mot de passe. Rien d'autre : ni entreprise, ni carte. Vous pouvez créer d'autres clés tout de suite et ajouter du crédit ou un forfait quand vous le décidez.
Comment fonctionne le crédit ?
Vous rechargez un solde à l'avance, de n'importe quel montant à partir de 5 €, par carte ou en crypto. Chaque requête au-delà des 2 500 requêtes gratuites du jour d'une clé y prélève 0,0001 €. Le crédit est partagé par toutes vos clés en paiement à l'usage, n'expire jamais, et rien n'est prélevé automatiquement. Lorsqu'il est vide, les requêtes au-delà du quota gratuit sont refusées avec 402 jusqu'à ce que vous rechargiez.
Comment acceptez-vous les paiements ?
Par carte via Polar, ou en crypto via NOWPayments : Bitcoin, Ethereum, USDT, USDC, Litecoin et bien d'autres. Le montant est fixé au moment du paiement et appliqué une fois le paiement confirmé. Tous les prix sont en euros.
Que comprend le forfait Unlimited ?
Une clé sans frais par requête sur tous les endpoints et tous les hôtes compatibles, pour 50 € par mois, utilisable depuis trois adresses IP au maximum par période glissante de 24 heures. Chaque forfait a sa propre clé ; commandez-en plusieurs si vous avez plusieurs applications. Voir les tarifs.
Existe-t-il un programme de parrainage ?
Oui. Votre tableau de bord contient un lien de parrainage ; 10 % de chaque facture payée par une personne inscrite grâce à ce lien est versé sur un solde de parrainage distinct de votre crédit. Transférez-le vers votre crédit quand vous le souhaitez, ou retirez-le en crypto à partir de 20 €. Les retraits sont traités manuellement et l'identifiant de la transaction apparaît dans votre tableau de bord.
Proposez-vous des codes promo ?
Parfois : des réductions en pourcentage ou d'un montant fixe sur une recharge ou un forfait, ou du crédit bonus. Saisissez le code lorsque vous créez la facture, ou sur n'importe quelle facture impayée avant de la régler.
Accès et limites
Comment le quota gratuit est-il compté ?
Par clé, par jour UTC, sur l'ensemble des endpoints et des hôtes compatibles. Les recherches d'IP par lot et les appels d'altitude à plusieurs points comptent une requête par élément. Les requêtes refusées et les erreurs serveur ne sont jamais comptées.
Que signifie la limite d'IP ?
Les premières adresses qui utilisent une clé occupent chacune un emplacement pendant 24 heures à partir de leur première requête. Une clé en paiement à l'usage a deux emplacements, une clé Unlimited trois. Lorsque les 24 heures d'un emplacement sont écoulées, il se libère de lui-même : si deux serveurs ont utilisé la clé à 02:00 et un troisième à 04:00, deux emplacements sont de nouveau libres à 02:00 le lendemain et le troisième à 04:00. Une requête depuis une nouvelle adresse alors que tous les emplacements sont occupés est refusée avec HTTP 403 et le code key_ip_limit ; la réponse indique quand le prochain emplacement se libère. Pour davantage de machines, créez d'autres clés ou ajoutez d'autres forfaits.
Puis-je appeler l'API depuis un navigateur ou une application mobile ?
CORS est activé, mais une clé placée dans le code client est visible par tous et atteindrait sa limite d'IP après quelques visiteurs. Appelez l'API depuis votre propre serveur et placez-y la clé. Il en va de même pour les remplacements de cartes JavaScript : les tuiles et les chargements de bibliothèque ne nécessitent pas de clé, les appels de géocodage doivent passer par votre serveur.
Existe-t-il une limite de débit en plus du quota journalier ?
Pas de limite fixe aujourd'hui. Un trafic qui ressemble à une boucle incontrôlée ou à une attaque peut être ralenti, et nous vous préviendrons si cela arrive un jour à l'une de vos clés. Les endpoints par lot existent pour que vous n'ayez pas besoin de centaines de requêtes par seconde.
Que se passe-t-il si ma clé fuit ?
Révoquez-la dans le tableau de bord et créez-en une nouvelle. En raison de la limite d'IP, une clé divulguée ne peut de toute façon pas être utilisée depuis plus de deux ou trois machines par jour, et comme le crédit est prépayé, personne ne peut faire grimper la facture au-delà du solde que vous avez choisi de charger.
Données et précision
Que signifie le champ precision ?
Il indique ce que représente le point renvoyé : house pour le bâtiment ou la parcelle, street pour une position interpolée le long de la rue, postcode pour le centre d'une zone de code postal, et admin pour le centre d'une ville, d'un district, d'une région ou d'un pays. Si vous avez demandé une maison et obtenu postcode, c'est que nous n'avons pas trouvé la maison.
Quels pays disposent de données au niveau du numéro de rue ?
La page de couverture indique le meilleur niveau disponible pour chacun des 249 pays et territoires, avec des filtres par région et par niveau. Elle est mise à jour à chaque publication de données.
Quelles sources de données utilisez-vous ?
Des données officielles d'adresses et postales, les données d'enregistrement et de routage d'Internet pour les recherches d'IP, la base de données standard des fuseaux horaires et des modèles de terrain mondiaux, ainsi que nos propres corrections. Chaque source est vérifiée par rapport aux autres avant d'être intégrée, et rien n'est extrait d'autres services de géocodage.
Puis-je stocker ou mettre en cache les résultats ?
Oui. Les résultats vous appartiennent : conservez-les dans votre base de données, mettez-les en cache et affichez-les sur n'importe quelle carte, y compris celles d'autres fournisseurs. La seule restriction des conditions est la revente des données brutes sous forme de votre propre service de géocodage.
À quelle fréquence les données sont-elles mises à jour ?
Les données d'adresses sont mises à jour chaque mois, les données IP chaque semaine, les règles de fuseau horaire à chaque nouvelle version publiée par l'IANA, et les données d'altitude lorsqu'un meilleur modèle public apparaît.
Prenez-vous en charge d'autres langues que l'anglais ?
Passez lang avec un code ISO 639-1 et les noms de lieux sont renvoyés dans cette langue lorsque nous les avons, sinon dans leur nom local. La mise en forme des adresses suit les conventions du pays où se trouve l'adresse.
Compatibilité
Les hôtes compatibles sont-ils des copies exactes des API d'origine ?
Les chemins, les paramètres et les formats de réponse correspondent à la documentation publique de chaque fournisseur, afin que le code client existant analyse les réponses sans modification. Les données sont les nôtres, donc les valeurs diffèrent, et quelques fonctionnalités propres à certains fournisseurs ne sont pas incluses. Chaque page de compatibilité liste les différences.
Le remplacement Google Maps JavaScript affiche-t-il les tuiles de carte de Google ?
Non. Le chargeur sur gapi.mygeocode.com fournit l'espace de noms google.maps avec nos propres tuiles de carte, notre géocodeur, notre saisie semi-automatique et notre service d'altitude derrière. Street View, Directions et Places Details ne sont pas inclus. Les chargements de carte ne sont pas décomptés de votre quota. Voir les remplacements JavaScript.
My Geocode est-il affilié à Google, Microsoft, HERE ou Mapbox ?
Non. Ces noms appartiennent à leurs propriétaires et ne sont utilisés ici que pour indiquer dans quels formats nous pouvons répondre.
Assistance
Existe-t-il une garantie de disponibilité ?
Les offres en libre-service ne comportent pas de SLA contractuel. Nous exploitons l'API dans plusieurs régions et affichons l'état en temps réel sur status.mygeocode.com. Si vous avez besoin d'un SLA écrit, parlez-nous-en.
Comment obtenir de l'aide ?
Écrivez à support@mygeocode.com. Les comptes payants reçoivent une réponse sous un jour ouvré. Les questions provenant de clés gratuites reçoivent aussi une réponse, selon le temps disponible.