Contours et entrées des bâtiments

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 unique de coordonnées latitude/longitude 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 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 les contours ou les entrées, et la couverture, varient d'une région à l'autre. En outre, vous devez s'attendent à recevoir des réponses de l'API contenant les contours d'un bâtiment, mais pas à l'entrée. La couverture en termes d'entrées devrait s'améliorer au fil du temps.

Commentaires

Cette fonctionnalité est expérimentale. N'hésitez pas à nous faire part de vos commentaires à l'adresse buildings-in-geocoding-feedback-channel@google.com.