Contours et entrées des bâtiments

Ce produit ou cette fonctionnalité est en phase expérimentale (pré-DG). La prise en charge des fonctionnalités et produits pré-DG peut être limitée, et il se peut que les modifications apportées à ces fonctionnalités ou produits ne soient pas compatibles avec d'autres versions pré-DG. Les offres en pré-DG sont couvertes par les Conditions spécifiques du service Google Maps Platform. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Le contour d'un bâtiment est un ensemble de paires de coordonnées de latitude/longitude qui définissent une Polygone 2D représentant la surface de la surface terrestre couverte par le bâtiment. Vous pouvez utiliser ce polygone pour dessiner les contours d'un bâtiment sur une carte. Une entrée est une paire de coordonnées latitude/longitude unique qui définit Emplacement d'un point d'entrée et de sortie d'un lieu par exemple, la porte d'une du bâtiment.

Paramètres supplémentaires

Inclure extra_computations=BUILDING_AND_ENTRANCES dans une requête de geocoding ; requête de geocoding inversé ou une requête de geocoding de lieux pour recevoir les entrées et les contours des bâtiments.

Exemple de requête

La requête suivante permet d'afficher les contours et les entrées d'un restaurant situé dans Mountain View, Californie, États-Unis:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJ4TTDdzS3j4AR78EQgu5EADA&extra_computations=BUILDING_AND_ENTRANCES&key=YOUR_API_KEY

Exemple de réponse

La réponse à la requête ci-dessus est la suivante:

{
  "entrances": [
    {
      "location": {
        "lat": 37.3925065,
        "lng": -122.0799465
      },
      "building_place_id": "ChIJVeHddzS3j4ARFZJVu4Cf27o"
    }
  ],
  "buildings" : [
    {
      "building_outlines" : [
        {
          "display_polygon" : {
            "coordinates" : [
              [
                [
                    -122.080188246116,
                    37.3926407183216
                ],
                [
                    -122.080281351765,
                    37.3924887558601
                ],
                [
                    -122.080023707261,
                    37.392390122414
                ],
                [
                    -122.079926266852,
                    37.3925369491992
                ],
                [
                    -122.080188246116,
                    37.3926407183216
                ]
              ]
            ],
            "type" : "Polygon"
          }
        }
      ],
      "place_id" : "ChIJVeHddzS3j4ARFZJVu4Cf27o"
    }
  ],
}

Lorsque cette fonctionnalité est activée, deux tableaux peuvent être renvoyés: buildings[] et entrances[].

Chaque résultat entrances comporte les champs suivants:

• location correspond aux coordonnées de latitude/longitude de l'entrée.
• building_place_id est l'ID de lieu du bâtiment qui contient l'entrée. Notez que ce paramètre n'est pas toujours renseigné.

Chaque résultat buildings comporte les champs suivants:

• place_id est l'identifiant unique du bâtiment. Consultez le Présentation des ID de lieu .
• building_outlines[] est un tableau de contours associés à le bâtiment. Pour l'instant, ce tableau ne comporte qu'une seule entrée. Chaque objet dans building_outlines[] comporte les champs suivants:
• display_polygon est l'encodage GeoJSON du polygone. qui correspond approximativement à la surface terrestre couverte par le bâtiment, à l'aide de l' format RFC 7946. Notez que le format RFC 7946 accepte les multipolygones, Ainsi, un objet display_polygon peut représenter plusieurs polygones.

Couverture

Cette fonctionnalité est disponible dans toutes les régions. Toutefois, tous les bâtiments des contours ou des entrées.

Commentaires

Cette fonctionnalité est expérimentale. N'hésitez pas à nous faire part de vos commentaires à l'adresse [e-mail].