Vous avez trouvé ce tutoriel intéressant ? Recommandez le en cliquant sur le bouton +1    

Tableau récapitulatif des différences entre les versions 2 et 3 de l'API Google Maps

Tutoriel publié le Mis à jour le

Attention : Le chargement des cartes via l'API Google Maps version 3 est gratuit jusqu'à un certain seuil. Au delà les cartes sont payantes. Pour en savoir plus lisez : Google limite de nombre de cartes gratuites affichables.

Différences entre l'API Google Maps version 2 et version 3

Vous trouverez, ci-contre, un tableau récapitulatif des principales différences et évolutions, entre l'API Google Maps JavaScript Version 2 et 3.

Dernières nouveautés :

Version 2 Version 3
Etat de la version
Version déclarée obsolète le 19 mai 2010.
Cependant, à compter de cette date, elle restera encore active durant 3 ans.
Plus aucune évolution ne sera apportée à cette version.
Etat de la version
Version déclarée officiellement active le 19 mai 2010.
Elle remplace désormais la version2.
Google vous invite désormais à migrer votre code vers la version 3.
Versions
  • v=2.s
  • v=2
  • v=2.x
Versions
  • v=3.8 (Actuelle)
  • v=3.7 (Stable)
  • v=3.6 (Gelée)
Mobiles
Non optimisée pour les mobiles.
Mobiles
Optimisée pour les mobiles, IPhone et Android par exemple.
Taille des fichiers
Importante.
Taille des fichiers
Réduite.
Clé API Google
Elle est obligatoire.
Clé API Google
La clé API Google Maps n'est plus nécessaire.
Espace de nommage
G* - Exemple : GLatLng
Espace de nommage
google.maps.* - Exemple : google.maps.LatLng
  MVC
l'API Google Maps JavaScript version 3 utilise MVC : Model, View, Controller.
sensor
Ce paramètre est apparu et devenu obligatoire dans la V2
sensor
Le paramètre sensor est obligatoire.
Exemple : sensor = true ou sensor = false
GBrowserIsCompatible
Permet de s'assurer que le navigateur utilisé par le visiteur est compatible avec l'API Google Maps JavaScript version 2.
GBrowserIsCompatible n'existe plus.
Type de carte par défaut
Par défaut le type de carte est le type Plan.
Il est possible d'insérer une carte Google Earth dans une carte Google Maps API JavaScript V2 à l'aide de GMapType.G_SATELLITE_3D_MAP.
Type de carte par défaut
Il n'existe plus de type de carte par défaut, il faut obligatoirement l'indiquer à l'aide de MapTypeId :
  • Plan : google.maps.MapTypeId.ROADMAP
  • Satellite : google.maps.MapTypeId.SATELLITE
  • Mixte : google.maps.MapTypeId.HYBRID
  • Relief : google.maps.MapTypeId.TERRAIN
Pour l'instant, l'API Google Maps JavaScript V3 ne permet pas de façon native de basculer vers une carte de type Google Earth.
GControl
Permet la création de boutons et contrôles
GControl
Il n'existe plus. Désormais, les contrôles sont de simples éléments HTML, du type balise <div/>, créés à l'aide de : document.createElement('div').
Contrôle Directionnel
Contrôle directionnel
Ce contrôle permet de déplacer la carte dans les 4 directions cardinales Nord, Sud, Est, Ouest.
La main située au centre du bouton permet de repositionner la carte sur son emplacement initial.
Contrôle Directionnel
Contrôle directionnel
Ce contrôle permet de déplacer la carte dans les 4 directions cardinales Nord, Sud, Est, Ouest.
Par contre, la main située au centre du bouton, bien que toujours présente, ne permet plus de repositionner la carte sur son emplacement initial.
GOverviewMapControl
GOverviewMapControl
Permet d'insérer une mini-carte en bas à droite de la carte principale, afin de géolocaliser celle-ci.
overviewMapControl
overviewMapControl
Deux nouvelles propriétés ont été ajoutées à l'objet google.maps.MapOptions



ainsi qu'un objet google.maps.OverviewMapControlOptions et sa propriété opened
Itinéraires à vélo
Non disponible.
Itinéraires à vélo
Bicycling Layer, permet d'afficher des pistes cyclabes. Indisponible en France pour l'instant.
Altitude d'un point
Indisponible dans la V2
Altitude d'un point
Elevation Service, permet de calculer l'altitude de points.
Polyline
Il est possible d'encoder, en amont, les Polylines à l'aide de fromEncoded() afin d'améliorer les performances d'affichage.
Polyline
L'encodage des Polylines, en amont, n'est plus possible dans l'API Google Maps version 3.
Rectangle
La création de Rectangles nécessite la création d'une fonction particulière
Rectangle
la création de Rectangles se fait à l'aide d'une classe intégrée dans l'API Google Maps JavaScript version 3 :
classe Rectangle
Cercle
La création de Cercles nécessite la création d'une fonction particulière
Cercle
la création de Cercles se fait à l'aide d'une classe intégrée dans l'API Google Maps JavaScript version 3 :
classe Circle
Géocodeur
Nombre de requêtes autorisées :
15.000 requêtes/IP/24 Heures ( Version Gratuite ).
Géocodeur
Il a été amélioré.
Nombre de requêtes autorisées :
2.500 requêtes/IP/24 Heures ( Version Gratuite ).
100.000 requêtes/IP/24 Heures pour les utilisateurs de Google Maps API Premier ( Version Payante )
Calcul d'itinéraire Calcul d'itinéraire
Il a été amélioré.
Possibilité d'optimiser un itinéraire.
Les info-bulles
  • Les Info-bulles à onglets sont intégrées dans l'API V2.
  • Une seule info-bulle peut-être ouverte et affichée à la fois.
  • Lorsqu'une info-bulle est ouverte, un click sur la carte permet de la fermer.
Les info-bulles
  • Les Info-bulles à onglets ne sont plus intégrées dans l'API V3.
  • Plusieurs info-bulles peuvent-être ouvertes et affichées simultanément.
  • Un clic sur la carte ne ferme plus une info-bulle ouverte.
Adsense et GoogleBar
insertion possible avec :
  • GAdsManager
  • GAdsManagerOptions
  • GAdsManagerStyle
  • GMap2.enableGoogleBar()
Adsense avec AdSense Library
Une bibliothèque nommèe AdSense Library permet d'insérer des publicités Adsense avec :
GoogleBar
Absent de l'API V3
GDownloadUrl
Permet de récupérer, de façon asynchrone, une ressource identifiée par une URL
GDownloadUrl
Pas d'équivalent. Il faut utiliser une solution externe à l'API Google Maps Javascript V3
GXmlHttp
Permet de créer une instance de XmlHttpRequest
GXmlHttp
Pas d'équivalent. Il faut utiliser une solution externe à l'API Google Maps Javascript V3.
Une solution de substitution est proposée par Google qui utilise XmlHttpRequest via le fichier utils.js : Retrouvez différents exemples ici : XML parsing
Calculs géométriques
Aucun utilitaire permettant d'effectuer des calculs.
Calculs géométriques
Une bibiothèque nommée Geometry Library a été ajoutée à la version 3.

Celle-ci contient des utilitaires permettant d'effectuer des calculs (angles, distances, zones).

Elle comporte deux espaces de nommage :
Panoramio Library
Néant
Insérez des images Panoramio avec Panoramio Library
Permet d'insérer des photos provenant de Panoramio dans une carte.

Animation de Marqueurs
Néant.
Animation de Marqueurs
Rendue possible grâce à la classe google.maps.Animation et ses deux constantes :
SSL
Indisponible dans la version gratuite.
SSL
L'accès à l' API Google Maps v3 (mais aussi l'API Static Maps et l'API Web Services Google Maps) dans sa version gratuite est désormais possible via HTTPS.

Pour charger l'API Google Maps Version 3 via HTTPS, il faut utiliser le nom d'hôte https://maps.googleapis.com/maps/api/js?key=VOTRE_CLE_API&sensor=TRUE_ou_FALSE.
Imagerie à 45°
Disponible
Imagerie à 45°
Disponible grâce à l'objet google.maps.MapOptions et ses deux propriétés :
Pour certaines villes uniquement.
Drawing Library
Néant
Dessinez des formes avec Drawing Library
Création d'une interface graphique qui permet à l'utilisateur de créer et modifier des polygones, polylines, overlays, marqueurs, cercles et rectangles.

google.maps.geometry.poly
Néant
google.maps.geometry.poly
Cet espace de nommage comporte deux nouvelles méthodes statiques :

Weather Library
Néant
Weather Library
Cette bibiliothèque vous permet d'ajouter la météo et la couche nuageuse sur une carte :

Problèmes de compatibilité (d'humeur ?) avec le navigateur Opéra.

Autres API Google cartographiques

Autres API Google en relation avec la cartographie et webmapping :

API Description
API Google Directions Cette API permet permet d'obtenir des informations sur les lieux (lieux géographiques, établissements, centre d'intérêt important, etc.) à l'aide d'une requête HTTP.
API Google Matrix Cette API permet de calculer la distance et le temps de parcours entre plusieurs origines et destinations à l'aide des matrices.
API Google Elevation Cette API permet permet d'obtenir l'altitude d'un point n'importe où à la surface de la Terre, y compris au fond des océans, à l'aide d'une requête HTTP.
API Google Geocoding Cette API permet de convertir une adresse postale en coordonnées géographique, et réciproquement, à l'aide d'une requête HTTP.
API Google Places Cette API permet d'obtenir des informations sur les lieux (lieux géographiques, établissements, centre d'intérêt important, etc.) à l'aide d'une requête HTTP.
API Static Maps V2 Cette API permet d'insérer des cartes sous forme d'image à l'aide de la balise <img/> et d'une URL.
API Google Street View Image Cette API permet d'insérer une Street View sous forme d'une image statique à l'aide de la balise <img/> et d'une URL.