خطوط کلی ساختمان و ورودی ها

طرح کلی ساختمان مجموعه ای از جفت مختصات طول و عرض جغرافیایی است که یک چندضلعی دوبعدی را نشان می دهد که سطح زمین پوشیده شده توسط ساختمان را نشان می دهد. می توانید از این چند ضلعی برای ترسیم طرح کلی ساختمان روی نقشه استفاده کنید. ورودی یک جفت مختصات طول و عرض جغرافیایی است که مکان یک نقطه ورودی و خروجی را در یک مکان مشخص می کند. مثلاً درب یک ساختمان.

پارامترهای اضافی

extra_computations=BUILDING_AND_ENTRANCES را در درخواست کدگذاری جغرافیایی ، درخواست رمزگذاری جغرافیایی معکوس ، یا درخواست کدگذاری جغرافیایی مکان‌ها برای دریافت ورودی‌ها و خطوط کلی ساختمان در پاسخ خود وارد کنید.

درخواست نمونه

پرس و جوی زیر خطوط کلی ساختمان و ورودی های یک رستوران در Mountain View، کالیفرنیا، ایالات متحده را فعال می کند:

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

پاسخ نمونه

پاسخ سوال بالا به شرح زیر است:

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

2 آرایه وجود دارد که با فعال شدن این ویژگی می توان آنها را برگرداند: buildings[] و entrances[] .

هر نتیجه entrances دارای فیلدهای زیر است:

• location مختصات طول و عرض جغرافیایی ورودی است.
• building_place_id شناسه مکان ساختمان است که دارای ورودی است. توجه داشته باشید که این پارامتر همیشه پر نخواهد شد.

هر نتیجه buildings دارای فیلدهای زیر است:

• place_id شناسه منحصر به فرد ساختمان است. برای جزئیات بیشتر به نمای کلی شناسه مکان مراجعه کنید.
• building_outlines[] آرایه ای از خطوط کلی مرتبط با ساختمان است. در حال حاضر این آرایه فقط یک ورودی خواهد داشت. هر شی در building_outlines[] دارای فیلدهای زیر است:
• display_polygon کدگذاری GeoJSON از چند ضلعی است که با استفاده از فرمت RFC 7946 ، سطح زمین را که توسط ساختمان پوشانده شده است، تقریبی می کند. توجه داشته باشید که فرمت RFC 7946 از چند ضلعی پشتیبانی می کند، بنابراین یک شی display_polygon می تواند چندین چند ضلعی را نشان دهد.

پوشش

این ویژگی در همه مناطق موجود است. با این حال همه ساختمان ها دارای خطوط کلی یا ورودی نخواهند بود و پوشش بسته به منطقه متفاوت خواهد بود. علاوه بر این، باید انتظار دریافت پاسخ‌های API را داشته باشید که حاوی طرح کلی ساختمان هستند اما ورودی ندارند. انتظار می رود پوشش ورودی با گذشت زمان بهبود یابد.

بازخورد

این یک ویژگی آزمایشی است. از بازخورد در buildings-in-geocoding-feedback-channel@google.com قدردانی خواهیم کرد.