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

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

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

הכללה extra_computations=BUILDING_AND_ENTRANCES בבקשת קידוד גיאוגרפי, היפוך של בקשת קידוד גיאוגרפי, או בקשת קידוד גיאוגרפי כדי לקבל כניסות ומתווה של בניינים בתשובה שלכם.

דוגמה לבקשה

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

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 אחד יכול לייצג מספר פוליגונים.

כיסוי

התכונה הזו זמינה בכל האזורים. אבל לא כל הבניינים קווי מתאר או כניסות.

משוב

זוהי תכונה ניסיונית. נשמח לקבל משוב בכתובת buildings-in-geocoding-feedback-channel@google.com.