קווים כלליים של מבנים וכניסות

מתאר של בניין הוא קבוצה של צמדי קואורדינטות של קו רוחב/קו אורך שמגדירים פוליגון דו-ממדי שמייצג את שטח הפנים של כדור הארץ שהבניין מכוסה. אפשר להשתמש בפוליגון הזה כדי לשרטט את קווי המתאר של בניין במפה. כניסה היא זוג קואורדינטות של קו אורך ורוחב שמגדיר את המיקום של נקודת הכניסה והיציאה למקום. לדוגמה, הדלת של בניין.

פרמטרים נוספים

כדי לקבל כניסות וקווי מתאר של מבנים בתגובה, צריך לכלול את הערך extra_computations=BUILDING_AND_ENTRANCES בבקשת גיאוקוד, בבקשת המרת קואורדינטות לכתובות (reverse geocoding) או בבקשת גיאוקוד של מקומות.

דוגמה לבקשה

השאילתה הבאה מאפשרת ליצור קווי מתאר וכניסות למסעדה מאונטן ויו, קליפורניה, ארצות הברית:

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.