Search - Post Search Inside Geometry

Служба:

Maps

Версия API:

1.0

Используйте для выполнения поиска в свободной форме в еще одной геометрии.

Api Post Search Inside Geometry is and HTTP POST request that allows you to perform a free form search inside a single geometry or multiple geometries. The search results that fall inside the geometry/geometries will be returned.<br><br>To send the geometry you will use a POSTrequest where the request body will contain theobject represented as aGeoJSONtype and theContent-Typeheader will be set toapplication/json. The geographical features to be searched can be modeled as Polygon and/or Circle geometries represented using any one of the following GeoJSON geometrycan be represented as aGeoJSONtypes:<ul><li>**GeoJSON FeatureCollection** <br>TheFeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. TheFeatureCollectioncan contain a max of 50GeoJSON Featureobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>Aobjects. EachFeature Featureobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>AFeatureobject for the Circle geometry is composed of a _center_ represented using aGeoJSON GeoJSON Pointtype and a _radius_ value (in meters) which must be specified in the object's properties along with the _subType_ property whose value should be 'Circle'.</li></ul><br> Please see the Examples section below for a sampleFeatureCollectionrepresentation.<br><br></li><li>**GeoJSON GeometryCollection**<br>Thegeometrycan be represented as aGeoJSON GeometryCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. TheGeoJSON Polygonobjects. EachGeometryCollectioncan contain a max of 50GeoJSON Polygonobject can have a max of 50 coordinates. Please see the Examples section below for a sampleGeometryCollectionrepresentation.<br><br></li><li>**GeoJSON Polygon**<br>Thegeometrycan be represented as aGeoJSON Polygonobject. This is the recommended option if the geometry contains a single Polygon. ThePolygonobject can have a max of 50 coordinates. Please see the Examples section below for a sampleПредставление многоугольников.

.

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}

С использованием необязательных параметров:

POST https://atlas.microsoft.com/search/geometry/{format}?api-version=1.0&query={query}&limit={limit}&language={language}&categorySet={categorySet}&extendedPostalCodesFor={extendedPostalCodesFor}&idxSet={idxSet}&view={view}&openingHours=nextSevenDays

Параметры URI

Имя	В	Обязательно	Тип	Описание
format	path	True	ResponseFormat	Требуемый формат ответа. Значение может быть либо json , либо xml.
api-version	query	True	string	Номер версии API Azure Maps
query	query	True	string	Имя POI для поиска (например, "статуя свободы", "starbucks", "pizza"). Должен быть правильно закодирован URL-адрес.
categorySet	query		integer[]	Разделенный запятыми список идентификаторов наборов категорий, который можно использовать для ограничения результата определенными категориями точек интереса. Порядок идентификации не имеет значения. Максимальное число поддерживаемых значений categorySet для каждого запроса — 10. При указании нескольких идентификаторов категорий возвращаются только те, которые относятся к (по крайней мере) одной из категорий из предоставленного списка. Список поддерживаемых категорий можно найти с помощью API категорий POI . Примеры использования categorySet=7315 (Поиск точек интереса из категории Ресторан) categorySet=7315025,7315017 (Поиск достопримечательностей категории итальянский или французский ресторан)
extendedPostalCodesFor	query		SearchIndexes[]	Индексы, для которых в результаты должны быть включены расширенные почтовые индексы. Доступные индексы: Addr = Диапазоны адресов Geo = Geographies PAD = адреса точек POI = точки интереса Str = Streets XStr = пересечения улиц (пересечений) Значение должно быть разделенным запятыми списком типов индексов (в любом порядке) или None для без индексов. По умолчанию для всех индексов, кроме географического, включены расширенные почтовые индексы. Расширенные списки почтовых индексов для географических регионов могут быть довольно длинными, поэтому их необходимо явно запрашивать при необходимости. Примеры использования extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Расширенный почтовый индекс возвращается как свойство extendedPostalCode адреса. Доступность зависит от региона.
idxSet	query		SearchIndexes[]	Разделенный запятыми список индексов, которые следует использовать для поиска. Порядок элементов не имеет значения. Доступные индексы: Addr = Интерполяция диапазона адресов, Geo = Geographies, PAD = Point Addresss, POI = Точки интереса, Str = Streets, Xstr = Cross Streets (пересечения)
language	query		string	Язык, на котором должны возвращаться результаты поиска. Должен быть одним из поддерживаемых языковых тегов IETF без учета регистра. Если данные на указанном языке недоступны для определенного поля, используется язык по умолчанию. Дополнительные сведения см. в разделе Поддерживаемые языки .
limit	query		integer	Максимальное количество возвращаемых ответов. По умолчанию: 10, минимум: 1 и максимум: 100
openingHours	query		OperatingHoursRange	Часы работы для POI (точки интереса). Доступность часов работы зависит от доступных данных. Если это не пройдено, информация о часах работы не будет возвращена. Поддерживаемое значение: nextSevenDays
view	query		LocalizedMapView	Параметр View (также называемый параметром "регион пользователя") позволяет отображать правильные карты для определенной страны или региона для геополитически спорных регионов. Разные страны или регионы имеют разные представления таких регионов, и параметр View позволяет приложению соответствовать представлению, требуемому для страны или региона, который будет обслуживать приложение. По умолчанию параметр View имеет значение Unified, даже если он не определен в запросе. Вы несете ответственность за определение расположения пользователей, а затем правильное указание параметра View для этого расположения. Кроме того, можно задать параметр View=Auto, который будет возвращать данные карты на основе IP-адреса запроса. Параметр View в Azure Maps должен использоваться в соответствии с применимыми законами, включая те, которые касаются сопоставления, страны или региона, в которой доступны карты, изображения и другие данные и содержимое третьих лиц, доступ к которому вы имеете через Azure Maps. Пример: view=IN. Дополнительные сведения и доступные представления см. в разделе Поддерживаемые представления.

Заголовок запроса

Имя	Обязательно	Тип	Описание
x-ms-client-id		string	Указывает, какая учетная запись предназначена для использования в сочетании с моделью безопасности Microsoft Entra ID. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Инструкции по использованию Microsoft Entra ID безопасности в Azure Maps см. в следующих статьях.

Текст запроса

Имя	Тип	Описание
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Допустимый объект GeoJSON. Дополнительные сведения см. в документе RFC 7946 .

Ответы

Имя	Тип	Описание
200 OK	SearchAddressResult	ОК
Other Status Codes	ErrorResponse	Произошла непредвиденная ошибка.

Безопасность

AADToken

Это Microsoft Entra потоков OAuth 2.0. При связывании с управлением доступом на основе ролей Azure его можно использовать для управления доступом к Azure Maps REST API. Элементы управления доступом на основе ролей Azure используются для назначения доступа к одной или нескольким учетным записям Azure Maps ресурсов или вложенным ресурсам. Любому пользователю, группе или субъекту-службе можно предоставить доступ через встроенную роль или пользовательскую роль, состоящую из одного или нескольких разрешений на Azure Maps REST API.

Для реализации сценариев рекомендуется ознакомиться с основными понятиями проверки подлинности. Таким образом, это определение безопасности предоставляет решение для моделирования приложений с помощью объектов, способных управлять доступом к определенным API и областям.

Примечание

• Это определение безопасности требует использования заголовкаx-ms-client-id, чтобы указать, к какому Azure Maps ресурсу приложение запрашивает доступ. Его можно получить из API управления Картами .
• Объект Authorization URL предназначен для экземпляра общедоступного облака Azure. Национальные облака имеют уникальные URL-адреса авторизации и конфигурации Microsoft Entra ID.
• Управление доступом на основе ролей Azure настраивается из плоскости управления Azure с помощью портал Azure, PowerShell, CLI, пакетов SDK для Azure или REST API.
• Использование веб-пакета SDK для Azure Maps позволяет настроить приложение на основе конфигурации для нескольких вариантов использования.
• Дополнительные сведения о платформа удостоверений Майкрософт см. в платформа удостоверений Майкрософт обзоре.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя	Описание
https://atlas.microsoft.com/.default	https://atlas.microsoft.com/.default

subscription-key

Это общий ключ, который подготавливается при создании учетной записи Azure Maps в портал Azure или с помощью PowerShell, CLI, пакетов AZURE SDK или REST API.

С помощью этого ключа любое приложение может получить доступ ко всем REST API. Другими словами, этот ключ можно использовать в качестве ключа master в учетной записи, в которую они выдаются.

Для общедоступных приложений мы рекомендуем использовать подход конфиденциальных клиентских приложений для доступа к Azure Maps REST API, чтобы обеспечить безопасное хранение ключа.

Тип: apiKey
В: query

SAS Token

Это маркер подписанного URL-адреса, созданный с помощью операции List SAS для ресурса Azure Maps через плоскость управления Azure с помощью портал Azure, PowerShell, CLI, пакетов SDK для Azure или REST API.

С помощью этого маркера любое приложение авторизовано для доступа с помощью элементов управления доступом на основе ролей Azure и точного контроля срока действия, скорости и регионов, используемых для конкретного маркера. Другими словами, маркер SAS можно использовать, чтобы разрешить приложениям управлять доступом более безопасным способом, чем общий ключ.

Для общедоступных приложений мы рекомендуем настроить определенный список разрешенных источников в ресурсе учетной записи map , чтобы ограничить использование маркера SAS и регулярно обновлять маркер SAS.

Тип: apiKey
В: header

Примеры

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Search for burger joints inside a geometry represented as a GeoJSON GeometryCollection type

Образец запроса

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=burger&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "GeometryCollection",
    "geometries": [
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -122.43576049804686,
              37.7524152343544
            ],
            [
              -122.43301391601562,
              37.70660472542312
            ],
            [
              -122.36434936523438,
              37.712059855877314
            ],
            [
              -122.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      },
      {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -123.43576049804686,
              37.7524152343544
            ],
            [
              -123.43301391601562,
              37.70660472542312
            ],
            [
              -123.36434936523438,
              37.712059855877314
            ],
            [
              -123.43576049804686,
              37.7524152343544
            ]
          ]
        ]
      }
    ]
  }
}

Пример ответа

Код состояния:

200

{
  "summary": {
    "query": "burger",
    "queryType": "NON_NEAR",
    "queryTime": 21,
    "numResults": 2,
    "offset": 0,
    "totalResults": 4,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "9P2i9inRyndAA-_V40J8oA",
      "score": 2.0041828156,
      "info": "search:ta:840061003419653-US",
      "poi": {
        "name": "Burger Joint",
        "phone": "+1 415-349-4331",
        "categorySet": [
          {
            "id": 7315015
          }
        ],
        "categories": [
          "fast food",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "fast food"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "hkr-N07YS6Gv2dOciQ9lwA",
      "score": 2.0041515827,
      "info": "search:ta:840067000526682-US",
      "poi": {
        "name": "Sound of Burgers",
        "categorySet": [
          {
            "id": 7315
          }
        ],
        "categories": [
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "167",
        "streetName": "Leland Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Visitacion Valley",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-2844",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "167 Leland Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.712228,
        "lon": -122.407022
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.71313,
          "lon": -122.40816
        },
        "btmRightPoint": {
          "lat": 37.71133,
          "lon": -122.40589
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.71241,
            "lon": -122.40693
          }
        }
      ]
    }
  ]
}

Search for pizza places inside a geometry represented as a GeoJSON FeatureCollection type

Образец запроса

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=pizza&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.143035,
                47.653536
              ],
              [
                -122.187164,
                47.617556
              ],
              [
                -122.114981,
                47.570599
              ],
              [
                -122.132756,
                47.654009
              ],
              [
                -122.143035,
                47.653536
              ]
            ]
          ]
        },
        "properties": {}
      },
      {
        "type": "Feature",
        "geometry": {
          "type": "Point",
          "coordinates": [
            -122.126986,
            47.639754
          ]
        },
        "properties": {
          "subType": "Circle",
          "radius": 100
        }
      }
    ]
  }
}

Пример ответа

Код состояния:

200

{
  "summary": {
    "query": "pizza",
    "queryType": "NON_NEAR",
    "queryTime": 34,
    "numResults": 2,
    "offset": 0,
    "totalResults": 21,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "-UuwTye4GGsea4KmCLvoqQ",
      "score": 2.1455535889,
      "info": "search:ta:840537000108972-US",
      "poi": {
        "name": "Biryani & Pizza House",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "15025",
        "streetName": "Northeast 24th Street",
        "municipality": "Redmond",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98052",
        "extendedPostalCode": "98052-5531",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15025 Northeast 24th Street, Redmond, WA 98052",
        "localName": "Redmond"
      },
      "position": {
        "lat": 47.630786,
        "lon": -122.139302
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.63169,
          "lon": -122.14064
        },
        "btmRightPoint": {
          "lat": 47.62989,
          "lon": -122.13797
        }
      },
      "entryPoints": [
        {
          "type": "minor",
          "position": {
            "lat": 47.63079,
            "lon": -122.13931
          }
        },
        {
          "type": "main",
          "position": {
            "lat": 47.63147,
            "lon": -122.13935
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "7r095LCcCSkdoGoeLcnvsQ",
      "score": 2.1454992294,
      "info": "search:ta:840537000103468-US",
      "poi": {
        "name": "Pagliacci Pizza",
        "categorySet": [
          {
            "id": 7315036
          }
        ],
        "url": "www.pagliacci.com/",
        "categories": [
          "pizza",
          "restaurant"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              },
              {
                "nameLocale": "en-US",
                "name": "pizza"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 11,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-20",
                "hour": 10,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-20",
                "hour": 11,
                "minute": 0
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "15238",
        "streetName": "Bel Red Road",
        "municipality": "Bellevue",
        "countrySecondarySubdivision": "King",
        "countrySubdivision": "WA",
        "countrySubdivisionName": "Washington",
        "countrySubdivisionCode": "WA",
        "postalCode": "98007",
        "extendedPostalCode": "98007-3815",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "15238 Bel Red Road, Bellevue, WA 98007",
        "localName": "Bellevue"
      },
      "position": {
        "lat": 47.628008,
        "lon": -122.13646
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 47.62891,
          "lon": -122.13779
        },
        "btmRightPoint": {
          "lat": 47.62711,
          "lon": -122.13513
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 47.6283,
            "lon": -122.13611
          }
        }
      ]
    }
  ]
}

Search for subs joints inside a geometry represented as a GeoJSON Polygon type

Образец запроса

HTTP

POST https://atlas.microsoft.com/search/geometry/json?api-version=1.0&query=subs&limit=2&openingHours=nextSevenDays

{
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          -122.43576049804686,
          37.7524152343544
        ],
        [
          -122.43301391601562,
          37.70660472542312
        ],
        [
          -122.36434936523438,
          37.712059855877314
        ],
        [
          -122.43576049804686,
          37.7524152343544
        ]
      ]
    ]
  }
}

Пример ответа

Код состояния:

200

{
  "summary": {
    "query": "subs",
    "queryType": "NON_NEAR",
    "queryTime": 42,
    "numResults": 2,
    "offset": 0,
    "totalResults": 5,
    "fuzzyLevel": 1
  },
  "results": [
    {
      "type": "POI",
      "id": "HOIWGiNwVv0z6bF8MO3EbA",
      "score": 2.1455111504,
      "info": "search:ta:840069009512242-US",
      "poi": {
        "name": "Adams Grub Truck",
        "phone": "+1 415-307-8844",
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ]
      },
      "address": {
        "streetNumber": "1465",
        "streetName": "Carroll Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Bayview",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94124",
        "extendedPostalCode": "94124-3604",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "1465 Carroll Avenue, San Francisco, CA 94124",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.72328,
        "lon": -122.39091
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.72418,
          "lon": -122.39205
        },
        "btmRightPoint": {
          "lat": 37.72238,
          "lon": -122.38977
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72348,
            "lon": -122.39073
          }
        }
      ]
    },
    {
      "type": "POI",
      "id": "bXbc0QxTRlkSo8GnU7EU-Q",
      "score": 2.1454677582,
      "info": "search:ta:840061001992959-US",
      "poi": {
        "name": "SUBWAY San Francisco San Francisco",
        "phone": "+1 415-657-9898",
        "brands": [
          {
            "name": "SUBWAY"
          }
        ],
        "categorySet": [
          {
            "id": 7315042
          }
        ],
        "categories": [
          "restaurant",
          "sandwich"
        ],
        "classifications": [
          {
            "code": "RESTAURANT",
            "names": [
              {
                "nameLocale": "en-US",
                "name": "sandwich"
              },
              {
                "nameLocale": "en-US",
                "name": "restaurant"
              }
            ]
          }
        ],
        "openingHours": {
          "mode": "nextSevenDays",
          "timeRanges": [
            {
              "startTime": {
                "date": "2024-03-13",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-13",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-14",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-14",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-15",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-15",
                "hour": 21,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-16",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-16",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-17",
                "hour": 9,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-17",
                "hour": 21,
                "minute": 0
              }
            },
            {
              "startTime": {
                "date": "2024-03-18",
                "hour": 8,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-18",
                "hour": 20,
                "minute": 30
              }
            },
            {
              "startTime": {
                "date": "2024-03-19",
                "hour": 7,
                "minute": 0
              },
              "endTime": {
                "date": "2024-03-19",
                "hour": 21,
                "minute": 30
              }
            }
          ]
        }
      },
      "address": {
        "streetNumber": "2599",
        "streetName": "San Bruno Avenue",
        "municipality": "San Francisco",
        "neighbourhood": "Portola",
        "countrySecondarySubdivision": "San Francisco",
        "countrySubdivision": "CA",
        "countrySubdivisionName": "California",
        "countrySubdivisionCode": "CA",
        "postalCode": "94134",
        "extendedPostalCode": "94134-1504",
        "countryCode": "US",
        "country": "United States",
        "countryCodeISO3": "USA",
        "freeformAddress": "2599 San Bruno Avenue, San Francisco, CA 94134",
        "localName": "San Francisco"
      },
      "position": {
        "lat": 37.729004,
        "lon": -122.403956
      },
      "viewport": {
        "topLeftPoint": {
          "lat": 37.7299,
          "lon": -122.40509
        },
        "btmRightPoint": {
          "lat": 37.7281,
          "lon": -122.40282
        }
      },
      "entryPoints": [
        {
          "type": "main",
          "position": {
            "lat": 37.72892,
            "lon": -122.40414
          }
        }
      ]
    }
  ]
}

Определения

Имя	Описание
Address	Адрес результата
AddressRanges	Описывает диапазон адресов по обе стороны улицы для результата поиска. Включаются координаты начального и конечного расположений диапазона адресов.
BoundingBox	Окно просмотра, которое охватывает результат, представленный левой верхней и нижней правой координатами окна просмотра.
BoundingBoxCompassNotation	Ограничивающий прямоугольник расположения.
Brand	Торговая марка, связанная с poi
Classification	Классификация возвращаемого poI
ClassificationName	Имя классификации
DataSources	Необязательный раздел. Идентификаторы ссылок для использования с API Get Поиск Polygon.
Entity	Источник типа сущности ограничивающего прямоугольника. Для обратного геокодирования это всегда равно положению.
EntryPoint	Точка входа для возвращаемого poI.
EntryPointType	Тип точки входа. Значение может быть main или дополнительным.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Сообщение об ошибке
GeographicEntityType	Тип сущности Geography. Отображается только в том случае, если entityType был запрошен и доступен.
GeoJsonFeature	Допустимый GeoJSON Feature тип объекта. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonFeatureCollection	Допустимый GeoJSON FeatureCollection тип объекта. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonGeometry	Допустимый GeoJSON объект geometry. Тип должен быть одним из семи допустимых геометрических типов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon и GeometryCollection. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonGeometryCollection	Допустимый GeoJSON GeometryCollection тип объекта. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonLineString	Допустимый GeoJSON LineString тип геометрии. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonMultiLineString	Допустимый GeoJSON MultiLineString тип геометрии. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonMultiPoint	Допустимый GeoJSON MultiPoint тип геометрии. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonMultiPolygon	Допустимый GeoJSON MultiPolygon тип объекта. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonPoint	Допустимый GeoJSON Point тип геометрии. Дополнительные сведения см. в документе RFC 7946 .
GeoJsonPolygon	Допустимый GeoJSON Polygon тип геометрии. Дополнительные сведения см. в документе RFC 7946 .
Geometry	Сведения о геометрической форме результата. Присутствует, только если тип == Geography.
LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".
LocalizedMapView	Параметр View (также называемый параметром "регион пользователя") позволяет отображать правильные карты для определенной страны или региона для геополитически спорных регионов. Разные страны или регионы имеют разные представления таких регионов, и параметр View позволяет приложению соответствовать представлению, требуемому для страны или региона, который будет обслуживать приложение. По умолчанию параметр View имеет значение Unified, даже если он не определен в запросе. Вы несете ответственность за определение расположения пользователей, а затем правильное указание параметра View для этого расположения. Кроме того, можно задать параметр View=Auto, который будет возвращать данные карты на основе IP-адреса запроса. Параметр View в Azure Maps должен использоваться в соответствии с применимыми законами, включая те, которые касаются сопоставления, страны или региона, в которой доступны карты, изображения и другие данные и содержимое третьих лиц, доступ к которому вы имеете через Azure Maps. Пример: view=IN. Дополнительные сведения и доступные представления см. в разделе Поддерживаемые представления.
MatchType	Типы совпадений для операции обратного поиска по адресу.
OperatingHours	Часы работы для POI (достопримечательностей).
OperatingHoursRange	Часы работы для POI (точки интереса). Доступность часов работы зависит от доступных данных. Если это не пройдено, информация о часах работы не будет возвращена. Поддерживаемое значение: nextSevenDays
OperatingHoursTime	Представляет дату и время
OperatingHoursTimeRange	Открытый диапазон времени для дня
PointOfInterest	Сведения о возвращенных poI, включая такие сведения, как имя, телефон, URL-адрес и классификации.
PointOfInterestCategorySet	Категория POI
QueryType	Тип возвращаемого запроса: NEARBY или NON_NEAR.
ResponseFormat	Требуемый формат ответа. Значение может быть либо json , либо xml.
SearchAddressResult	Этот объект возвращается из успешного вызова Поиск.
SearchAddressResultItem	Результирующий объект для ответа API Поиск.
SearchAddressResultType	Одно из двух значений: POI Улица Географический регион Точечный адрес Диапазон адресов Перекресток
SearchIndexes	Индексы, для которых в результаты должны быть включены расширенные почтовые индексы. Доступные индексы: Addr = Диапазоны адресов Geo = Geographies PAD = адреса точек POI = точки интереса Str = Streets XStr = пересечения улиц (пересечений) Значение должно быть разделенным запятыми списком типов индексов (в любом порядке) или None для без индексов. По умолчанию для всех индексов, кроме географического, включены расширенные почтовые индексы. Расширенные списки почтовых индексов для географических регионов могут быть довольно длинными, поэтому их необходимо явно запрашивать при необходимости. Примеры использования extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Расширенный почтовый индекс возвращается как свойство extendedPostalCode адреса. Доступность зависит от региона.
SearchInsideGeometryRequest	Этот тип представляет текст запроса для службы Поиск Inside Geometry.
SearchSummary	Объект Summary для ответа API Поиск.

Address

Адрес результата

Имя	Тип	Описание
boundingBox	BoundingBoxCompassNotation	Ограничивающий прямоугольник расположения.
buildingNumber	string	Номер здания на улице. Не рекомендуется, вместо этого используйте streetNumber.
country	string	название страны или региона
countryCode	string	Страна (примечание. Это двухбуквенный код, а не название страны или региона.)
countryCodeISO3	string	Код страны ISO alpha-3
countrySecondarySubdivision	string	Округ
countrySubdivision	string	Область, республика, край
countrySubdivisionCode	string	countrySubdivisionCode с префиксом countryCode ( countryCode-countrySubdivisionCode ), а дефис формирует код ISO 3166-2. Примеры: TX для Техаса, SCT для Шотландии и ON для Онтарио.
countrySubdivisionName	string	Полное имя первого уровня административной иерархии страны или региона. Это поле отображается только в том случае, если countrySubdivision представлено в сокращенной форме. Поддерживается только для США, Канады и Соединенного Королевства.
countryTertiarySubdivision	string	Именованной области
crossStreet	string	Название пересекаемой улицы.
extendedPostalCode	string	Расширенный почтовый индекс (доступность зависит от региона).
freeformAddress	string	Адресная строка, отформатированная в соответствии с правилами форматирования страны или региона источника результата или в случае страны или региона, его полного названия страны или региона.
localName	string	Компонент адреса, представляющий имя географической области или местности, которая группирует несколько адресуемых объектов для целей адресации, не являясь административной единицей. Это поле используется для построения freeformAddress свойства . localName представляет почтовый муниципалитет. В зависимости от расположения — localName это общеизвестное название города или города. Для общего названия города используйте localName вместо municipality.
municipality	string	Город или город Примечание. municipality Представляет жилой муниципалитет. В зависимости от расположения municipality значение может отличаться от общего имени города или города. Для общего имени города или города рекомендуется localName использовать значение вместо municipality значения.
municipalitySubdivision	string	Sub / Super City
neighbourhood	string	Район — это географически локализованная территория в пределах города или города с отличительными характеристиками и социальными взаимодействиями между жителями.
postalCode	string	Почтовый индекс / почтовый индекс
routeNumbers	string[]	Коды, используемые для однозначной идентификации улицы
street	string	Название улицы. Не рекомендуется, вместо этого используйте streetName.
streetName	string	Название улицы.
streetNameAndNumber	string	Название и номер улицы.
streetNumber	string	Номер здания на улице.

AddressRanges

Описывает диапазон адресов по обе стороны улицы для результата поиска. Включаются координаты начального и конечного расположений диапазона адресов.

Имя	Тип	Описание
from	LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".
rangeLeft	string	Диапазон адресов на левой стороне улицы.
rangeRight	string	Диапазон адресов на правой стороне улицы.
to	LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".

BoundingBox

Окно просмотра, которое охватывает результат, представленный левой верхней и нижней правой координатами окна просмотра.

Имя	Тип	Описание
btmRightPoint	LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".
topLeftPoint	LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".

BoundingBoxCompassNotation

Ограничивающий прямоугольник расположения.

Имя	Тип	Описание
entity	Entity	Источник типа сущности ограничивающего прямоугольника. Для обратного геокодирования это всегда равно положению.
northEast	string	Северо-восточная широта, координата долготы ограничивающего прямоугольника в виде с плавающей точкой с разделиниями-запятыми
southWest	string	Юго-западная широта, координата долготы ограничивающего прямоугольника в виде с плавающей точкой, разделенной запятыми

Brand

Торговая марка, связанная с poi

Имя	Тип	Описание
name	string	Название торговой марки

Classification

Классификация возвращаемого poI

Имя	Тип	Описание
code	string	Свойство Code
names	ClassificationName[]	Массив имен

ClassificationName

Имя классификации

Имя	Тип	Описание
name	string	Name - свойство
nameLocale	string	Свойство "Языковой стандарт имени"

DataSources

Необязательный раздел. Идентификаторы ссылок для использования с API Get Поиск Polygon.

Имя	Тип	Описание
geometry	Geometry	Сведения о геометрической форме результата. Присутствует, только если тип == Geography.

Entity

Источник типа сущности ограничивающего прямоугольника. Для обратного геокодирования это всегда равно положению.

Имя	Тип	Описание
position	string	Сущность Position

EntryPoint

Точка входа для возвращаемого poI.

Имя	Тип	Описание
position	LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".
type	EntryPointType	Тип точки входа. Значение может быть main или дополнительным.

EntryPointType

Тип точки входа. Значение может быть main или дополнительным.

Имя	Тип	Описание
main	string
minor	string

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Тип дополнительных сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Сообщение об ошибке

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

GeographicEntityType

Тип сущности Geography. Отображается только в том случае, если entityType был запрошен и доступен.

Имя	Тип	Описание
Country	string	название страны или региона
CountrySecondarySubdivision	string	Округ
CountrySubdivision	string	Область, республика, край
CountryTertiarySubdivision	string	Именованной области
Municipality	string	Город или город
MunicipalitySubdivision	string	Sub / Super City
Neighbourhood	string	Районе
PostalCodeArea	string	Почтовый индекс / почтовый индекс

GeoJsonFeature

Допустимый GeoJSON Feature тип объекта. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
featureType	string	Тип функции. Значение зависит от модели данных, частью этой функции является текущий компонент. Некоторые модели данных могут иметь пустое значение.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Допустимый GeoJSON объект geometry. Тип должен быть одним из семи допустимых геометрических типов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon и GeometryCollection. Дополнительные сведения см. в документе RFC 7946 .
id	string	Идентификатор компонента.
type	string: Feature	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonFeatureCollection

Допустимый GeoJSON FeatureCollection тип объекта. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
features	GeoJsonFeature[]	Содержит список допустимых GeoJSON Feature объектов.
type	string: FeatureCollection	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonGeometry

Допустимый GeoJSON объект geometry. Тип должен быть одним из семи допустимых геометрических типов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon и GeometryCollection. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
type	GeoJsonObjectType	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonGeometryCollection

Допустимый GeoJSON GeometryCollection тип объекта. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
geometries	GeoJsonGeometry[]: GeoJsonGeometryCollection[] GeoJsonLineString[] GeoJsonMultiLineString[] GeoJsonMultiPoint[] GeoJsonMultiPolygon[] GeoJsonPoint[] GeoJsonPolygon[]	Содержит список допустимых GeoJSON геометрических объектов. Обратите внимание , что координаты в GeoJSON находятся в порядке x, y (долгота, широта).
type	string: GeometryCollection	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonLineString

Допустимый GeoJSON LineString тип геометрии. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
coordinates	number[]	Координаты геометрии GeoJson LineString .
type	string: LineString	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonMultiLineString

Допустимый GeoJSON MultiLineString тип геометрии. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
coordinates	number[]	Координаты геометрии GeoJson MultiLineString .
type	string: MultiLineString	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonMultiPoint

Допустимый GeoJSON MultiPoint тип геометрии. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
coordinates	number[]	Координаты геометрии GeoJson MultiPoint .
type	string: MultiPoint	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonMultiPolygon

Допустимый GeoJSON MultiPolygon тип объекта. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
coordinates	number[]	Содержит список допустимых GeoJSON Polygon объектов. Обратите внимание , что координаты в GeoJSON находятся в порядке x, y (долгота, широта).
type	string: MultiPolygon	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonPoint

Допустимый GeoJSON Point тип геометрии. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
coordinates	number[]	— Position это массив чисел с двумя или более элементами. Первые два элемента — долгота и широта, именно в этом порядке. Высота или высота — необязательный третий элемент. Дополнительные сведения см. в документе RFC 7946 .
type	string: Point	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

GeoJsonPolygon

Допустимый GeoJSON Polygon тип геометрии. Дополнительные сведения см. в документе RFC 7946 .

Имя	Тип	Описание
coordinates	number[]	Координаты для GeoJson Polygon типа geometry.
type	string: Polygon	Указывает тип элемента GeoJSON. Должен быть одним из девяти допустимых типов объектов GeoJSON: Point, MultiPoint, LineString, MultiLineString, Polygon, MultiPolygon, GeometryCollection, Feature и FeatureCollection.

Geometry

Сведения о геометрической форме результата. Присутствует, только если тип == Geography.

Имя	Тип	Описание
id	string	Передайте его как geometryId в API получения Поиск Polygon, чтобы получить геометрическую информацию для этого результата.

LatLongPairAbbreviated

Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".

Имя	Тип	Описание
lat	number	Свойство Latitude
lon	number	Свойство Долгота

LocalizedMapView

Параметр View (также называемый параметром "регион пользователя") позволяет отображать правильные карты для определенной страны или региона для геополитически спорных регионов. Разные страны или регионы имеют разные представления таких регионов, и параметр View позволяет приложению соответствовать представлению, требуемому для страны или региона, который будет обслуживать приложение. По умолчанию параметр View имеет значение Unified, даже если он не определен в запросе. Вы несете ответственность за определение расположения пользователей, а затем правильное указание параметра View для этого расположения. Кроме того, можно задать параметр View=Auto, который будет возвращать данные карты на основе IP-адреса запроса. Параметр View в Azure Maps должен использоваться в соответствии с применимыми законами, включая те, которые касаются сопоставления, страны или региона, в которой доступны карты, изображения и другие данные и содержимое третьих лиц, доступ к которому вы имеете через Azure Maps. Пример: view=IN.

Дополнительные сведения и доступные представления см. в разделе Поддерживаемые представления.

Имя	Тип	Описание
AE	string	Объединенные Арабские Эмираты (арабское представление)
AR	string	Аргентина (аргентинское представление)
Auto	string	Данные карт возвращаются с учетом IP-адреса запроса.
BH	string	Бахрейн (арабское представление)
IN	string	Индия (индийское представление)
IQ	string	Ирак (арабское представление)
JO	string	Иордан (арабское представление)
KW	string	Кувейт (арабское представление)
LB	string	Ливан (арабское представление)
MA	string	Марокко (марокканское представление)
OM	string	Оман (арабское представление)
PK	string	Пакистан (пакистанское представление)
PS	string	Палестинская Автономия (арабское представление)
QA	string	Катар (арабское представление)
SA	string	Саудовская Аравия (арабское представление)
SY	string	Сирия (арабское представление)
Unified	string	Унифицированное представление (прочие)
YE	string	Йемен (арабское представление)

MatchType

Типы совпадений для операции обратного поиска по адресу.

Имя	Тип	Описание
AddressPoint	string
HouseNumberRange	string
Street	string

OperatingHours

Часы работы для POI (достопримечательностей).

Имя	Тип	Описание
mode	string	Значение, используемое в запросе: none или nextSevenDays
timeRanges	OperatingHoursTimeRange[]	Список диапазонов времени на следующие 7 дней

OperatingHoursRange

Часы работы для POI (точки интереса). Доступность часов работы зависит от доступных данных. Если это не пройдено, информация о часах работы не будет возвращена. Поддерживаемое значение: nextSevenDays

Имя	Тип	Описание
nextSevenDays	string	Показывает часы работы на следующей неделе, начиная с текущего дня по местному времени POI.

OperatingHoursTime

Представляет дату и время

Имя	Тип	Описание
date	string	Представляет текущую дату календаря в часовом поясе POI, например 07.02.2019.
hour	integer	Часы в 24-часовом формате по местному времени POI; Возможные значения: от 0 до 23.
minute	integer	Минуты относятся к местному времени POI; Возможные значения: от 0 до 59.

OperatingHoursTimeRange

Открытый диапазон времени для дня

Имя	Тип	Описание
endTime	OperatingHoursTime	Точка в диапазоне следующих 7 дней при закрытии заданного POI или начало диапазона, если он был закрыт до диапазона.
startTime	OperatingHoursTime	Точка в диапазоне следующих 7 дней, когда открывается данный poI, или начало диапазона, если он был открыт до диапазона.

PointOfInterest

Сведения о возвращенных poI, включая такие сведения, как имя, телефон, URL-адрес и классификации.

Имя	Тип	Описание
brands	Brand[]	Массив торговых марок. Имя торговой марки для возвращаемого poI.
categories	string[]	Массив категорий
categorySet	PointOfInterestCategorySet[]	Список наиболее конкретных категорий POI
classifications	Classification[]	Массив классификации
name	string	Имя свойства POI
openingHours	OperatingHours	Часы работы для POI (точки интереса).
phone	string	Свойство "Номер телефона"
url	string	Свойство URL-адреса веб-сайта

PointOfInterestCategorySet

Категория POI

Имя	Тип	Описание
id	integer	Идентификатор категории

QueryType

Тип возвращаемого запроса: NEARBY или NON_NEAR.

Имя	Тип	Описание
NEARBY	string	Поиск выполнялись вокруг определенной широты и долготы с определенным радиусом
NON_NEAR	string	Поиск выполняется глобально, без смещений на определенную широту и долготу, без определенного радиуса

ResponseFormat

Требуемый формат ответа. Значение может быть либо json , либо xml.

Имя	Тип	Описание
json	string	Формат обмена данными нотации объектов JavaScript
xml	string	Расширяемый язык разметки

SearchAddressResult

Этот объект возвращается из успешного вызова Поиск.

Имя	Тип	Описание
results	SearchAddressResultItem[]	Список результатов Поиск API.
summary	SearchSummary	Объект Summary для ответа API Поиск

SearchAddressResultItem

Результирующий объект для ответа API Поиск.

Имя	Тип	Описание
address	Address	Адрес результата
addressRanges	AddressRanges	Описывает диапазон адресов по обе стороны улицы для результата поиска. Включаются координаты начального и конечного расположений диапазона адресов.
dataSources	DataSources	Необязательный раздел. Идентификатор геометрии ссылки для использования с API получения Поиск polygon.
detourTime	integer	Время объезда в секундах. Возвращается только для вызовов API маршрута Поиск.
dist	number	Прямое расстояние между результатом и расположением геобия в метрах.
entityType	GeographicEntityType	Тип сущности Geography. Отображается только в том случае, если entityType был запрошен и доступен.
entryPoints	EntryPoint[]	Массив точек входа. Они описывают типы входов, доступных на месте. Тип может быть "main" для main входов, таких как входная дверь или вестибюль, и "дополнительный" для боковых и задних дверей.
id	string	Свойство Id
info	string	Сведения об исходном источнике данных result. Используется для запросов на поддержку.
matchType	MatchType	Сведения о типе соответствия. Одно из двух значений: AddressPoint HouseNumberRange Улица
poi	PointOfInterest	Сведения о возвращенных poI, включая такие сведения, как имя, телефон, URL-адрес и классификации.
position	LatLongPairAbbreviated	Расположение, представленное в виде широты и долготы с использованием коротких имен "lat" & "lon".
score	number	Значение в результирующем наборе, указывающее относительную оценку соответствия между результатами. Это позволяет определить, что результат x в два раза выше, чем результат y, если значение x равно 2x значению y. Значения зависят от запросов и предназначены только как относительное значение для одного результирующих наборов.
type	SearchAddressResultType	Одно из двух значений: POI Улица Географический регион Точечный адрес Диапазон адресов Перекресток
viewport	BoundingBox	Окно просмотра, охватывающее результат, представленный верхней левой и нижней правой координатами окна просмотра.

SearchAddressResultType

Одно из двух значений:

• POI
• Улица
• Географический регион
• Точечный адрес
• Диапазон адресов
• Перекресток

Имя	Тип	Описание
Address Range	string
Cross Street	string
Geography	string
POI	string
Point Address	string
Street	string

SearchIndexes

Индексы, для которых в результаты должны быть включены расширенные почтовые индексы.

Доступные индексы:

Addr = Диапазоны адресов

Geo = Geographies

PAD = адреса точек

POI = точки интереса

Str = Streets

XStr = пересечения улиц (пересечений)

Значение должно быть разделенным запятыми списком типов индексов (в любом порядке) или None для без индексов.

По умолчанию для всех индексов, кроме географического, включены расширенные почтовые индексы. Расширенные списки почтовых индексов для географических регионов могут быть довольно длинными, поэтому их необходимо явно запрашивать при необходимости.

Примеры использования

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

Расширенный почтовый индекс возвращается как свойство extendedPostalCode адреса. Доступность зависит от региона.

Имя	Тип	Описание
Addr	string
Geo	string
PAD	string
POI	string
Str	string
Xstr	string

SearchInsideGeometryRequest

Этот тип представляет текст запроса для службы Поиск Inside Geometry.

Имя	Тип	Описание
geometry	GeoJsonObject: GeoJsonFeature GeoJsonFeatureCollection	Допустимый объект GeoJSON. Дополнительные сведения см. в документе RFC 7946 .

SearchSummary

Объект Summary для ответа API Поиск.

Имя	Тип	Описание
fuzzyLevel	integer	Максимальный уровень нечеткости, необходимый для предоставления результатов.
geoBias	LatLongPairAbbreviated	Указание того, что внутренняя поисковая система применила геопространственный уклон для улучшения ранжирования результатов. В некоторых методах на это можно повлиять, задав параметры lat и lon там, где они доступны. В других случаях это чисто внутренний.
limit	integer	Максимальное число ответов, которые будут возвращены
numResults	integer	Количество результатов в ответе.
offset	integer	Начальная смещение возвращаемых результатов в полном результирующем наборе.
query	string	Параметр запроса, который использовался для получения этих результатов поиска.
queryTime	integer	Время, затраченное на разрешение запроса, в миллисекундах.
queryType	QueryType	Тип возвращаемого запроса: NEARBY или NON_NEAR.
totalResults	integer	Общее число найденных результатов.