My Geocode

Remplacement compatible d'OpenCage

OpenCage utilise un seul endpoint pour le géocodage direct et inverse et renvoie un bloc d'annotations riche. opencage.mygeocode.com fait de même, y compris les annotations de fuseau horaire, de devise, d'indicatif téléphonique et de type what3words que lisent les utilisateurs d'OpenCage.

Changez un seul nom d'hôte

Hôte d'origine
  • api.opencagedata.com
À utiliser à la placeopencage.mygeocode.com
Paramètre de clékey (facultatif : toute adresse dispose de 2 500 requêtes par jour sans clé ; mettez ici votre clé My Geocode pour le crédit, les forfaits et un historique d'utilisation)
Avant
curl "https://api.opencagedata.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_OPENCAGE_KEY"
Après
curl "https://opencage.mygeocode.com/geocode/v1/json?q=Colosseum+Rome&key=YOUR_MYGEOCODE_KEY"

Pourquoi changer

La même requête, la même structure de réponse, 2 500 requêtes gratuites par jour et par clé, sans obligation d'attribution ni clause d'usage non commercial.

Le même quota gratuit, avec ou sans clé. Les requêtes vers opencage.mygeocode.com sont décomptées des mêmes 2 500 requêtes gratuites par jour dont votre adresse, ou votre clé, dispose sur nos propres endpoints. Au-delà, crédit prépayé à 0,0001 € par requête, ou 50 € par mois pour une clé Unlimited. L'inscription ne demande qu'une adresse e-mail, rien d'autre.

Voir les tarifs Obtenir une clé gratuite

Endpoints

Chemin sur opencage.mygeocode.comRôleFourni par
/geocode/v1/json?q=...Géocodage directGéocodage direct
/geocode/v1/json?q=lat,lngGéocodage inverseGéocodage inverse
/geocode/v1/geojson?q=...Sortie GeoJSONGéocodage direct

Exemple de réponse

Voici ce que renvoie la requête ci-dessus. Les noms de champs, l'imbrication et les types suivent OpenCage. Seules les données qu'ils contiennent sont les nôtres.

Réponse de opencage.mygeocode.com
{
  "documentation": "https://www.mygeocode.com/compatibility/opencage/",
  "licenses": [ { "name": "My Geocode Terms", "url": "https://www.mygeocode.com/terms/" } ],
  "rate": { "limit": 2500, "remaining": 2483, "reset": 1756339200 },
  "results": [
    {
      "annotations": {
        "DMS": { "lat": "41° 53' 24.72'' N", "lng": "12° 29' 31.92'' E" },
        "callingcode": 39,
        "currency": { "iso_code": "EUR", "name": "Euro", "symbol": "€" },
        "flag": "🇮🇹",
        "timezone": { "name": "Europe/Rome", "now_in_dst": 1, "offset_sec": 7200, "offset_string": "+0200", "short_name": "CEST" }
      },
      "bounds": {
        "northeast": { "lat": 41.8905, "lng": 12.4932 },
        "southwest": { "lat": 41.8897, "lng": 12.4914 }
      },
      "components": {
        "ISO_3166-1_alpha-2": "IT",
        "ISO_3166-1_alpha-3": "ITA",
        "_category": "travel/tourism",
        "_type": "attraction",
        "attraction": "Colosseo",
        "city": "Roma",
        "continent": "Europe",
        "country": "Italia",
        "country_code": "it",
        "postcode": "00184",
        "road": "Piazza del Colosseo",
        "state": "Lazio"
      },
      "confidence": 9,
      "formatted": "Colosseo, Piazza del Colosseo, 00184 Roma RM, Italia",
      "geometry": { "lat": 41.8902, "lng": 12.4922 }
    }
  ],
  "status": { "code": 200, "message": "OK" },
  "total_results": 1
}

Détails et différences

Aucune clé n'est nécessaire pour les 2 500 premières requêtes de la journée. Pour utiliser une clé My Geocode, placez-la là où se trouvait votre clé OpenCage : le paramètre de requête key. L'en-tête X-API-Key, Authorization: Bearer et l'authentification HTTP Basic (la clé comme nom d'utilisateur) fonctionnent aussi sur tous les hôtes, de sorte que les bibliothèques clientes qui s'authentifient à leur manière continuent de fonctionner sans modification.

Les mentions de copyright, noms de licence, conditions et liens de confidentialité de la réponse sont les nôtres et non ceux du fournisseur d'origine. Tout le reste conserve la structure d'origine.

  • Le bloc rate indique votre quota gratuit réel, ce qu'il en reste et quand il se réinitialise.
  • Les endpoints json et geojson sont tous deux servis.
  • Pas d'endpoint par lots, car l'original n'en a pas. Pour les traitements en masse, utilisez POST /v1/forward ou /v1/reverse sur api.mygeocode.com (jusqu'à 100 par appel, une requête chacun).

Si votre client dépend d'un champ ou d'un comportement qui ne figure pas ici, dites-le-nous. Les écarts de compatibilité sont corrigés rapidement, car ils sont généralement minimes.

Autres hôtes compatibles

Fonctionnement des hôtes compatibles, la vue d'ensemble et les remplacements compatibles pour bibliothèques JavaScript.