Une requête utilisant l'API Google Geocoding doit avoir la structure suivante :

http://maps.googleapis.com/maps/api/geocode/format_de_sortie?vos_parametres

où format_de_sortie peut prendre l'une des deux valeurs suivantes :

• json (recommandé) indique que la réponse doit être au format JSON (JavaScript Object Notation).
  

  http://maps.googleapis.com/maps/api/geocode/json?vos_parametres

• xml indique que la réponse doit être au format XML
  

  http://maps.googleapis.com/maps/api/geocode/xml?vos_parametres

Pour accéder à l'API Google Geocoding via le protocole HTTPS, utilisez la forme suivante :

https://maps.googleapis.com/maps/api/geocode/format_de_sortie?vos_parametres

Le protocole HTTPS est recommandé dans les applications où les requêtes peuvent comporter des données confidentielles sur l'utilisateur, telle que leur emplacement par exemple.

Dans les deux cas, certains paramètres sont obligatoires alors que d'autres sont facultatifs. Comme c'est la norme dans les URL, tous les paramètres sont séparés par le caractère 'esperluette' ( & ). La liste des paramètres et leurs valeurs possibles sont énumérées ci-dessous.

L'API de géocodage Google définit une requête de géocodage en utilisant les paramètres suivants dans l'URL:

• address obligatoire : Adresse postale que vous souhaitez géocoder.*

OU

• latlng obligatoire : Valeur textuelle de la latitude/longitude pour laquelle vous souhaitez obtenir l'adresse postale la plus proche, lisible par l'homme*

• bounds facultatif : Limite de la zone de sélection dans laquelle les résultats du géocodeur seront influencés de façon plus importante. Pour plus d'informations, voir Zone d'influence.
• region facultatif : Code du pays, indiqué sous la forme d'un ccTLD ("Top Level Domain") à deux cararctères. Pour plus d'informations, voir Pays d'influence.
• language facultatif : Langue dans laquelle retourner les résultats. Voir la liste des langues supportées. Notez que Google met souvent à jour cette liste, de ce fait elle n'est pas exhaustive. Si language n'est pas fourni, le géocodeur tentera d'utiliser la langue maternelle du domaine à partir duquel la requête a été envoyée, chaque fois que cela est possible.
• sensor obligatoire : Indique si oui ou non la requête de géocodage provient d'un appareil mobile doté d'un GPS. Cette valeur doit être égale soit à true soit à false.

Note * : Vous pouvez passer soit une address, soit un latlng dans la requête. Si vous passez un latlng, le géocodeur exécutera alors un géocodage inversé. Voir Géocodage inversé pour plus d'informations.

Les paramètres bounds et region influencent les résultats du géocodeur sans toutefois les restreindre.