Remplacement compatible de Google Maps Platform

Les services web Geocoding, Places Autocomplete, Time Zone et Elevation répondent tous aux mêmes chemins sur gapi.mygeocode.com, avec la même structure JSON que celle renvoyée par Google. Changez l'hôte, mettez votre clé My Geocode dans le paramètre key, et le reste de votre code reste tel quel.

Changez un seul nom d'hôte

Hôte d'origine	`maps.googleapis.com`
À utiliser à la place	`gapi.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://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_GOOGLE_KEY"

Après

curl "https://gapi.mygeocode.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_MYGEOCODE_KEY"

Pourquoi changer

Google exige un compte de facturation et une clé à chaque appel, et facture chaque requête selon chaque SKU. Ici, une clé gratuite couvre les 2 500 premiers appels de la journée, et le prix ensuite est de 0,0001 € par requête ou un forfait fixe de 50 € par mois.

Le même quota gratuit, avec ou sans clé. Les requêtes vers gapi.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 gapi.mygeocode.com	Rôle	Fourni par
`/maps/api/geocode/json?address=...`	Géocodage direct	Géocodage direct
`/maps/api/geocode/json?latlng=lat,lng`	Géocodage inverse	Géocodage inverse
`/maps/api/place/autocomplete/json?input=...`	Places Autocomplete (prédictions avec coordonnées)	Saisie semi-automatique d'adresses
`/maps/api/timezone/json?location=lat,lng&timestamp=...`	Time Zone API	Recherche de fuseau horaire
`/maps/api/elevation/json?locations=lat,lng\|lat,lng`	Elevation API	Recherche d'altitude

Exemple de réponse

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

Réponse de gapi.mygeocode.com

{
  "results": [
    {
      "address_components": [
        { "long_name": "1600", "short_name": "1600", "types": ["street_number"] },
        { "long_name": "Amphitheatre Parkway", "short_name": "Amphitheatre Pkwy", "types": ["route"] },
        { "long_name": "Mountain View", "short_name": "Mountain View", "types": ["locality", "political"] },
        { "long_name": "Santa Clara County", "short_name": "Santa Clara County", "types": ["administrative_area_level_2", "political"] },
        { "long_name": "California", "short_name": "CA", "types": ["administrative_area_level_1", "political"] },
        { "long_name": "United States", "short_name": "US", "types": ["country", "political"] },
        { "long_name": "94043", "short_name": "94043", "types": ["postal_code"] }
      ],
      "formatted_address": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "geometry": {
        "location": { "lat": 37.4224428, "lng": -122.0842467 },
        "location_type": "ROOFTOP",
        "viewport": {
          "northeast": { "lat": 37.4237918, "lng": -122.0828977 },
          "southwest": { "lat": 37.4210938, "lng": -122.0855957 }
        }
      },
      "place_id": "mg.us.addr.5e1b2c7a9f",
      "plus_code": { "compound_code": "CWC8+W5 Mountain View, CA, USA", "global_code": "849VCWC8+W5" },
      "types": ["street_address"]
    }
  ],
  "status": "OK"
}

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é Google : le paramètre de requête key, ou l'en-tête X-Goog-Api-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 corps d'erreur correspondent à l'API appelée : la Time Zone API renvoie errorMessage avec status, les autres error_message, la liste de résultats vide, puis status.
Les réponses de fuseau horaire utilisent ZERO_RESULTS en pleine mer, comme Google, et respectent language.
Elevation accepte locations, une polyligne encodée enc:, et path avec samples, jusqu'à 512 points comme le permet Google ; chaque point compte ici pour une requête.

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.