Contornos e entradas de edifícios

Este produto ou recurso é experimental (pré-GA). Os produtos e recursos pré-GA têm suporte limitado, e é possível que as mudanças neles não sejam compatíveis com versões anteriores. As Soluções pré-GA são cobertas pelos Termos de Serviço da Plataforma Google Maps. Para mais detalhes, consulte as descrições da fase de lançamento.

O contorno de uma construção é 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 pela construção. Você pode usar este polígono para desenhar o contorno de uma construção em um mapa. Entrada é um par único de coordenadas de latitude/longitude que define a localização de um ponto de entrada e saída em um lugar, como a porta de um edifício.

Parâmetros adicionais

Inclua extra_computations=BUILDING_AND_ENTRANCES em uma solicitação de geocodificação, uma solicitação de geocodificação reversa ou uma solicitação de geocodificação de lugares para receber entradas e contornos de edifícios na sua resposta.

Exemplo de solicitação

A consulta a seguir ativa contornos e entradas de construções para 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 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 é preenchido.

Cada resultado de buildings tem os seguintes campos:

• place_id é o identificador exclusivo do edifício. Consulte a visão geral dos IDs de lugar para mais detalhes.
• building_outlines[] é uma matriz de contornos associados ao edifício. A partir de agora, 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 pela construção, 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 têm contornos ou entradas, e a cobertura varia de acordo com a região. Além disso, você deve receber respostas da API que contenham um esboço de edifício, mas nenhuma entrada. Espera-se que a cobertura de entrada melhore com o tempo.

Feedback

Este é um recurso experimental. Envie seu feedback para [e-mail].