Contornos e entradas de edifícios

O contorno de um edifício é um conjunto de pares de coordenadas de latitude/longitude que definem um polígono 2D que representa a área da superfície da Terra coberta pelo edifício. Você pode usar esse polígono para desenhar o contorno de um edifício em um mapa. Uma entrada é um único par de coordenadas de latitude/longitude que define o local de um ponto de entrada e saída de um lugar. Por exemplo, a porta de um edifício.

Parâmetros adicionais

Incluir extra_computations=BUILDING_AND_ENTRANCES em uma solicitação de geocodificação, solicitação de geocodificação inversa ou uma solicitação de geocodificação de lugares para receber entradas e contornos de construções na sua resposta.

Exemplo de solicitação

A consulta a seguir ativa os contornos e as entradas de um restaurante em Mountain View, Califórnia, Estados Unidos:

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

Exemplo de resposta

A resposta da consulta acima é a seguinte:

{
  "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"
    }
  ],
}

Há duas matrizes que podem ser retornadas quando esse recurso está ativado: buildings[] e entrances[].

Cada resultado de entrances tem os seguintes campos:

• location são as coordenadas de latitude/longitude da entrada.
• building_place_id é o ID de lugar da construção que contém a entrada. Esse parâmetro nem sempre será preenchido.

Cada resultado buildings tem os seguintes campos:

• place_id é o identificador exclusivo do edifício. Consulte a visão geral do ID de lugar para mais detalhes.
• building_outlines[] é uma matriz de contornos associados ao edifício. No momento, essa matriz terá apenas uma entrada. Cada objeto em building_outlines[] tem os seguintes campos:
• display_polygon é a codificação GeoJSON do polígono. que se aproxima da área da superfície da Terra coberta pelo edifício, usando o formato RFC 7946. O formato RFC 7946 oferece suporte a vários polígonos, Portanto, um objeto display_polygon pode representar vários polígonos.

Cobertura

Esse recurso está disponível em todas as regiões. No entanto, nem todas as construções terão contornos ou entradas, e a cobertura varia por região. Além disso, você vai receber respostas da API que contêm um contorno do edifício, mas sem entradas. Espera-se que a cobertura de entrada melhore com o tempo.

Feedback

Este é um recurso experimental. Envie seu feedback para buildings-in-geocoding-feedback-channel@google.com.