Vous êtes prêt !

Pour passer à l'étape de développement, accédez à notre documentation pour les développeurs.

Activer Google Places API Web Service

Pour commencer, nous allons vous guider à travers la console Google Developers et effectuer deux ou trois petites choses :

  1. Créer ou choisir un projet
  2. Activer Google Places API Web Service
  3. Créer les clés appropriées
Continuer

Ajout de lieux

En ajoutant un lieu, vous pouvez compléter les données de la base de données Google Maps avec les données de votre propre application. Vous pouvez ainsi :

  • Mettre à jour instantanément les données dans la base de données Google pour vos utilisateurs.
  • Transmettre de nouveaux lieux au processus de modération pour déterminer s'ils peuvent être intégrés à la base de données Google Places.
  • Démarquer votre application des autres applications offrant la même fonctionnalité.
  • Créer des applications destinées à une base d'utilisateurs ou un lieu géographique spécifique.
  • Affiner les résultats d'une recherche de lieu lancée à partir de votre application.
  1. Présentation
  2. Ajouter un lieu
  3. Supprimer un lieu
  4. Codes de statut
  5. Messages d'erreur
  6. Paramètre sensor

Présentation

Lorsque vous ajoutez un lieu, ce dernier est immédiatement disponible dans les recherches de lieux à proximité lancées par votre application. Le nouveau lieu est transmis à un processus de modération pour déterminer s'il peut être intégré à Google Maps. Un lieu nouvellement ajouté n'apparaît dans les résultats de recherche de texte ou de radar, ou dans toute autre application, que lorsqu'il a été approuvé par le processus de modération.

Vous pouvez également supprimer des lieux qui ont été ajoutés par votre application tant qu'ils n'ont pas été modérés. Une fois modéré et ajouté à la base de données Google, un lieu ne peut plus être supprimé. Les lieux non approuvés par le processus de modération continuent d'être visibles à l'application qui les a soumis.

Ajouter un lieu

Une requête d'ajout de lieu est une requête HTTP POST semblable à l'exemple ci-dessous :


JSON
POST https://maps.googleapis.com/maps/api/place/add/json?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

{
  "location": {
    "lat": -33.8669710,
    "lng": 151.1958750
  },
  "accuracy": 50,
  "name": "Google Shoes!",
  "phone_number": "(02) 9374 4000",
  "address": "48 Pirrama Road, Pyrmont, NSW 2009, Australia",
  "types": ["shoe_store"],
  "website": "http://www.google.com.au/",
  "language": "en-AU"
}
      
XML
POST https://maps.googleapis.com/maps/api/place/add/xml?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

<PlaceAddRequest>
  <location>
    <lat>-33.8669710</lat>
    <lng>151.1958750</lng>
  </location>
  <accuracy>50</accuracy>
  <name>Google Shoes!</name>
  <phone_number>(02) 9374 4000</phone_number>
  <address>48 Pirrama Road, Pyrmont, NSW 2009, Australia</address>
  <type>shoe_store</type>
  <website>http://www.google.com.au/</website>
  <language>en-AU</language>
</PlaceAddRequest>
      

Notez que le chemin URL indique le format d'entrée et de sortie :

  • json (recommandé) spécifie que le format d'entrée et de sortie est JavaScript Object Notation (JSON).
  • xml spécifie que le format d'entrée et de sortie est XML.

L'URL doit contenir le paramètre suivant :

  • keyClé d'API de votre application. Elle identifie votre application à des fins de gestion des quotas. Ainsi, les lieux ajoutés à partir de votre application sont immédiatement disponibles pour votre application. Pour plus d'informations, voir Obtenir une clé.

Le corps de la requête contient des informations sur le lieu. Il doit être structuré en fonction du paramètre output spécifié (JSON ou XML).

  • accuracy - Précision du signal du lieu sur lequel cette requête est basée, exprimée en mètres.
  • address (recommandé pour augmenter les chances d'approbation par le processus de modération) - Adresse du lieu que vous souhaitez ajouter. Si un lieu est associé à une adresse lisible au format approprié, il a plus de chances d'être approuvé par le processus de modération pour être intégré à la base de données Google Maps.
  • language - Langue dans laquelle le nom du lieu est présenté. Voir la liste des langues prises en charge et leurs codes. Notez que cette liste peut ne pas être exhaustive, car nous mettons régulièrement à jour les langues prises en charge.
  • location (obligatoire) - Point géographique, spécifié sous la forme de valeurs de latitude et longitude, correspondant au lieu que vous souhaitez ajouter.
  • name (obligatoire) - Nom complet du lieu. Limité à 255 caractères.
  • phone_number (recommandé pour augmenter les chances d'approbation par le processus de modération) - Numéro de téléphone associé au lieu. Si un lieu est associé à un numéro de téléphone au format approprié, il a plus de chances d'être approuvé par le processus de modération pour être intégré à la base de données Google Maps. Ce numéro doit être au format local ou international :
    • Le format local peut différer en fonction du pays. Voir cet article Wikipédia. Par exemple, le numéro de téléphone local du bureau de Google à Sydney, Australie, est le (02) 9374 4000.
    • Le format international inclut le code pays, précédé du signe plus (+). Par exemple, le numéro de téléphone international du bureau de Google à Sydney, Australie, est le +61 2 9374 4000.
  • types (obligatoire) - Catégorie à laquelle ce lieu appartient. Alors qu'il existe plusieurs types, un seul peut actuellement être spécifié pour un lieu. Les requêtes XML requièrent un seul élément <type>. Pour plus d'informations, voir la liste des types pris en charge. Si aucun des types pris en charge ne correspond à ce lieu, vous pouvez indiquer le paramètre other.
  • website (recommandé pour augmenter les chances d'approbation par le processus de modération) — URL pointant vers le site Web officiel de ce lieu, tel que la page d'accueil d'une entreprise. Si un lieu est associé à une adresse de site Web au format approprié, il a plus de chances d'être approuvé par le processus de modération pour être intégré à la base de données Google Maps.

Réponses aux requêtes d'ajout de lieu

Les réponses aux requêtes d'ajout de lieu sont renvoyées au format spécifié par le paramètre output dans le chemin URL de la requête.

L'API renvoie un code de statut, et si la requête est acceptée, la réponse inclut les propriétés suivantes pour le nouveau lieu :

  • place_id : Identifiant textuel qui identifie un lieu de manière unique. Pour extraire des informations sur le lieu, indiquez cet identifiant dans le champ placeid d'une requête de détails sur un lieu. Pour plus d'informations sur les identifiants de lieu, voir la présentation des identifiants de lieu.
  • scope : Spécifie la validité de l'identifiant de lieu (place_id). Les valeurs possibles pour ce champ sont les suivantes :
    • APP : L'identifiant de lieu est reconnu par votre application uniquement. Remarque : La validité d'une réponse à une requête d'ajout de lieu est toujours APP dans la mesure où le lieu n'a pas encore été traité par le processus de modération.
    • GOOGLE : Le lieu est disponible pour les autres applications et sur Google Maps. Comme mentionné ci-dessus, une réponse à une requête d'ajout de lieu n'a jamais une validité à l'échelle de Google.
  • reference : Jeton unique que vous pouvez utiliser pour extraire des informations supplémentaires sur ce lieu. Remarque : La propriété reference est progressivement abandonnée au profit de place_id. Voir l'avis lié à l'abandon sur cette page.
  • id : Identifiant fixe unique représentant ce lieu. Cet identifiant ne peut pas être utilisé pour extraire des informations sur ce lieu, mais reste valide d'une session à l'autre. Il peut être utilisé pour regrouper des données sur ce lieu et pour vérifier l'identité d'un lieu dans plusieurs recherches séparées. Remarque : La propriété id est progressivement abandonnée au profit de place_id. Reportez-vous à l'avis lié à l'abandon de cette page.
{
  "status": "OK",
  "place_id": "CdIJN2t_tDeuEmsRUsoyG83frY4",
  "scope": "APP",
  "reference": "CiQgAAAAeTQS1RtzAyVRVjHcRiIWmWeqcAl3k7bluW7GINLDULESEHozTQhy6OHJw03ziDvY1uEaFAP_vDRhK-UbWw3Gd7Ulqm3eRjIs",
  "id": "6947fc4007436a71dbda51ef9a58627c8e8858f9"
}

Supprimer un lieu

Un lieu peut être supprimé uniquement si :

  • Le lieu a été ajouté par l'application qui réclame sa suppression.
  • La requête d'ajout du lieu n'a pas été approuvée par le processus de modération Google Maps et le lieu est par conséquent disponible uniquement pour l'application qui l'a ajouté.

Si vous tentez de supprimer un lieu ne répondant pas à ces critères, l'API renvoie un code de statut REQUEST_DENIED.

Une requête de suppression d'un lieu est une requête HTTP POST au format suivant :


JSON
POST https://maps.googleapis.com/maps/api/place/delete/json?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

{
  "place_id": "place ID"
}
      
XML
POST https://maps.googleapis.com/maps/api/place/delete/xml?key=YOUR_API_KEY HTTP/1.1
Host: maps.googleapis.com

<PlaceDeleteRequest>
  <place_id>place ID</place_id>
</PlaceDeleteRequest>
      

Notez que le chemin URL indique le format d'entrée et de sortie :

  • json (recommandé) spécifie que le format de sortie est JavaScript Object Notation (JSON)
  • xml spécifie que le format d'entrée et de sortie est XML

L'URL doit contenir le paramètre suivant :

  • keyClé d'API de votre application. Elle identifie votre application à des fins de gestion des quotas. Ainsi, les lieux ajoutés à partir de votre application sont immédiatement disponibles pour votre application. Pour plus d'informations, voir Obtenir une clé.

Le corps de la requête doit être structuré en fonction du paramètre output spécifié (JSON ou XML). Il doit inclure l'un des deux champs suivants :

  • place_id : Chaîne identifiant le lieu qui doit être supprimé, renvoyée par une recherche de lieu. Pour plus d'informations sur les identifiants de lieu, voir la présentation des identifiants de lieu.
  • Vous pouvez également spécifier un paramètre reference pour identifier le lieu. Notez que la propriété reference est progressivement abandonnée au profit de place_id. Reportez-vous à l'avis lié à l'abandon de cette page.

Réponses aux requêtes de suppression de lieu

Les réponses aux requêtes de suppression de lieu sont renvoyées au format spécifié par le paramètre output dans le chemin URL de la requête.

Une requête de suppression de lieu approuvée renvoie le code de statut suivant :

{
  "status": "OK"
}

Codes de statut

Les codes de statut des requêtes d'ajout/de suppression de lieu sont les suivants :

  • OK indique qu'aucune erreur ne s'est produite ; le lieu a été ajouté ou supprimé avec succès.
  • UNKNOWN_ERROR indique une erreur côté serveur ; un nouvel essai pourrait aboutir.
  • OVER_QUERY_LIMIT indique que vous avez dépassé votre quota.
  • REQUEST_DENIED indique que votre requête a été rejetée. Vous avez peut-être tenté de supprimer un lieu ajouté par une autre application ou traité par le processus de modération Google Maps.
  • INVALID_REQUEST indique généralement que certains paramètres de la requête sont manquants. Ce code s'affiche également lorsque vous tentez d'ajouter un lieu dont le paramètre name contient plus de 255 caractères.
  • NOT_FOUND peut s'afficher pour les requêtes de suppression de lieu afin d'indiquer que la référence transmise ne correspond à aucun lieu.

Messages d'erreur

Lorsque Google Places API Web Service renvoie un code de statut différent de OK, un champ error_message supplémentaire peut s'afficher dans l'objet de la réponse. Ce champ contient des informations plus détaillées sur les causes de ce code de statut.

Paramètre sensor

Google Places API Web Service exigeait auparavant l'insertion du paramètre sensor pour savoir si votre application utilisait un capteur afin de déterminer la position géographique de l'utilisateur. Désormais, ce paramètre n'est plus obligatoire.

Envoyer des commentaires concernant…

location_on
Google Places API Web Service