Search - Post Search Inside Geometry

Ссылка

Служба:: Maps

Версия API:: 1.0

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

API Post Search Inside GeometryPOST 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. To send the geometry you will use a 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. To send the geometry you will use a POSTrequest where the request body will contain thegeometryobject represented as aGeoJSONtype and theApplication-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 GeoJSONtypes:<ul><li>**GeoJSON FeatureCollection** Thegeometrycan be represented as aGeoJSON FeatureCollectionobject. This is the recommended option if the geometry contains both Polygons and Circles. TheFeatureCollectioncan contain a max of 50Компонент GeoJSONobjects. Eachobject for the Polygon geometry can have a max of 50 coordinates and it's properties must be empty.</li><li>AКомпонентobject should represent either a Polygon or a Circle with the following conditions:<ul style="list-style-type:none"><li>AКомпонент Функцияobject for the Circle geometry is composed of a _center_ represented using aGeoJSON 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> Please see the Examples section below for a sampleFeatureCollectionrepresentation. </li><li>**GeoJSON GeometryCollection** Thegeometrycan be represented as aGeoJSON GeometryCollectionobject. This is the recommended option if the geometry contains a list of Polygons only. TheGeometryCollectioncan contain a max of 50GeoJSON Polygonobjects. EachPolygonobject can have a max of 50 coordinates. Please see the Examples section below for a sampleGeometryCollectionrepresentation. </li><li>**GeoJSON Polygon** 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 samplePolygon' представления.

.

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", "пицца"). Должен быть правильно закодирован URL-адрес.
categorySet	query		integer[]	Разделенный запятыми список идентификаторов наборов категорий, которые можно использовать для ограничения результата определенным категориями интересов. Порядок идентификаторов не имеет значения. Максимальное число значений `categorySet`, поддерживаемых для каждого запроса, равно 10. При указании нескольких идентификаторов категорий возвращаются только pois, принадлежащие (по крайней мере) одной из категорий из предоставленного списка. Список поддерживаемых категорий можно обнаружить с помощью API категорий POI. Примеры использования: категорияSet=7315 (поиск точек интереса от ресторана категории) категорияSet=7315025 7315017 (точки поиска категории либо итальянский или французский ресторан)
extendedPostalCodesFor	query		SearchIndexes[]	Индексы, для которых расширенные почтовые коды должны быть включены в результаты. Доступные индексы: Addr = диапазоны адресов гео = географии PAD = адреса точек POI = точки интереса Str = улицы XStr = кросс-улицы (пересечения) Значение должно быть разделенным запятыми списком типов индексов (в любом порядке) или Нет для индексов. По умолчанию расширенные почтовые коды включаются для всех индексов, кроме geo. Расширенные почтовые списки для географических регионов могут быть довольно длинными, поэтому они должны быть явно запрошены при необходимости. Примеры использования: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Расширенный почтовый индекс возвращается в виде свойства расширенного почтового индекса extendedPostalCode адреса. Доступность зависит от региона.
idxSet	query		SearchIndexes[]	Разделенный запятыми список индексов, которые должны использоваться для поиска. Порядок элементов не имеет значения. Доступные индексы: Addr = Интерполяция диапазона адресов, Гео = География, PAD = Point Addresss, POI = Точки интереса, Str = Street, Xstr = Cross Street (пересечения)
language	query		string	Язык, в котором должны быть возвращены результаты поиска. Должен быть одним из поддерживаемых тегов языка IETF, не учитывает регистр. Если данные на указанном языке недоступны для определенного поля, используется язык по умолчанию. Дополнительные сведения см. в поддерживаемых языках.
limit	query		integer minimum: 1 maximum: 100	Максимальное количество возвращаемых ответов. По умолчанию: 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. Он представляет уникальный идентификатор учетной записи Azure Maps и может быть получен из API учетной записи уровня управления Azure Maps. Сведения о том, как использовать безопасность идентификатора Microsoft Entra в Azure Maps, см. в следующих статьях .

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

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

Ответы

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

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

AADToken

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

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

Примечание.

Для этого определения безопасности требуется использовать заголовок x-ms-client-id, чтобы указать, к какой ресурсу Azure Maps приложение запрашивает доступ. Это можно получить из API управления карт.
Authorization URL зависит от экземпляра общедоступного облака Azure. В национальных облаках есть уникальные URL-адреса авторизации и конфигурации идентификатора Microsoft Entra.
Управление доступом на основе ролей 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, пакетов SDK Azure или REST API.

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

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

Тип: apiKey
В: query

SAS Token

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

С помощью этого маркера любой приложению разрешен доступ с помощью управления доступом на основе ролей Azure и точного управления сроком действия, скоростью и регионами, используемыми для конкретного маркера. Другими словами, маркер 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 Search Polygon.
Entity	Источник типа сущности ограничивающего поля. Для обратного геокодирования это всегда равно позиции.
EntryPoint	Точка входа для возвращаемого poI.
EntryPointType	Тип точки входа. Значение может быть либо основной, либо дополнительных.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
GeographicEntityType	Тип сущности Geography. Присутствует только в том случае, если entityType был запрошен и доступен.
GeoJsonFeature	Допустимый тип объекта `GeoJSON Feature`. Дополнительные сведения см. в RFC 7946.
GeoJsonFeatureCollection	Допустимый тип объекта `GeoJSON FeatureCollection`. Дополнительные сведения см. в RFC 7946.
GeoJsonGeometry	Допустимый объект `GeoJSON` геометрии. Тип должен быть одним из семи допустимых типов геометрии 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	Одно из: ПОИ Улица География Точечный адрес Диапазон адресов Перекресток
SearchIndexes	Индексы, для которых расширенные почтовые коды должны быть включены в результаты. Доступные индексы: Addr = диапазоны адресов гео = географии PAD = адреса точек POI = точки интереса Str = улицы XStr = кросс-улицы (пересечения) Значение должно быть разделенным запятыми списком типов индексов (в любом порядке) или Нет для индексов. По умолчанию расширенные почтовые коды включаются для всех индексов, кроме geo. Расширенные почтовые списки для географических регионов могут быть довольно длинными, поэтому они должны быть явно запрошены при необходимости. Примеры использования: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None Расширенный почтовый индекс возвращается в виде свойства расширенного почтового индекса extendedPostalCode адреса. Доступность зависит от региона.
SearchInsideGeometryRequest	Этот тип представляет текст запроса для службы "Поиск внутри геометрии".
SearchSummary	Сводный объект для ответа API поиска.

Address

Object

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

Имя	Тип	Описание
boundingBox	BoundingBoxCompassNotation	Ограничивающий прямоугольник расположения.
buildingNumber	string	Номер здания на улице. Вместо этого используйте streetNumber.
country	string	имя страны или региона
countryCode	string	Страна (примечание. Это двухбуквенный код, а не имя страны или региона.)
countryCodeISO3	string	Код страны ISO альфа-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

Object

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

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

BoundingBox

Object

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

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

BoundingBoxCompassNotation

Object

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

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

Brand

Object

Бренд, связанный с POI

Имя	Тип	Описание
name	string	Название бренда

Classification

Object

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

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

ClassificationName

Object

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

Имя	Тип	Описание
name	string	Name, свойство
nameLocale	string	Свойство Name Locale

DataSources

Object

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

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

Entity

Перечисление

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

Значение	Описание
position	Позиция сущности

EntryPoint

Object

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

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

EntryPointType

Перечисление

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

Значение	Описание
main
minor

ErrorAdditionalInfo

Object

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

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

ErrorDetail

Object

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

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

ErrorResponse

Object

Ответ на ошибку

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

GeographicEntityType

Перечисление

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

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

GeoJsonFeature

Object

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

Имя	Тип	Описание
featureType	string	Тип функции. Значение зависит от модели данных, из которой входит текущая функция. Некоторые модели данных могут иметь пустое значение.
geometry	GeoJsonGeometry: GeoJsonGeometryCollection GeoJsonLineString GeoJsonMultiLineString GeoJsonMultiPoint GeoJsonMultiPolygon GeoJsonPoint GeoJsonPolygon	Допустимый объект `GeoJSON` геометрии. Тип должен быть одним из семи допустимых типов геометрии 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

Object

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

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

GeoJsonGeometry

Object

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

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

GeoJsonGeometryCollection

Object

Допустимый тип объекта 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

Object

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

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

GeoJsonMultiLineString

Object

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

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

GeoJsonMultiPoint

Object

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

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

GeoJsonMultiPolygon

Object

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

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

GeoJsonPoint

Object

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

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

GeoJsonPolygon

Object

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

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

Geometry

Object

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

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

LatLongPairAbbreviated

Object

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

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

LocalizedMapView

Перечисление

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

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

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

MatchType

Перечисление

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

Значение	Описание
AddressPoint
HouseNumberRange
Street

OperatingHours

Object

Часы работы для POI (точки интереса).

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

OperatingHoursRange

Перечисление

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

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

OperatingHoursTime

Object

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

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

OperatingHoursTimeRange

Object

Диапазон времени открытия в течение дня

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

PointOfInterest

Object

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

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

PointOfInterestCategorySet

Object

Категория POI

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

QueryType

Перечисление

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

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

ResponseFormat

Перечисление

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

Значение	Описание
json	формат обмена данными для объектов JavaScript
xml	расширяемый язык разметки

SearchAddressResult

Object

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

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

SearchAddressResultItem

Object

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

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

SearchAddressResultType

Перечисление

Одно из:

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

Значение	Описание
Address Range
Cross Street
Geography
POI
Point Address
Street

SearchIndexes

Перечисление

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

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

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

гео = географии

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

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

Str = улицы

XStr = кросс-улицы (пересечения)

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

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

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

extendedPostalCodesFor=POI

extendedPostalCodesFor=PAD,Addr,POI

extendedPostalCodesFor=None

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

Значение	Описание
Addr
Geo
PAD
POI
Str
Xstr

SearchInsideGeometryRequest

Object

Этот тип представляет текст запроса для службы "Поиск внутри геометрии".

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

SearchSummary

Object

Сводный объект для ответа API поиска.

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

Поделиться через

Search - Post Search Inside Geometry

Параметры URI

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

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

Ответы

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

AADToken

Области

subscription-key

SAS Token

Примеры

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

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

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

Определения

Address

AddressRanges

BoundingBox

BoundingBoxCompassNotation

Brand

Classification

ClassificationName

DataSources

Entity

EntryPoint

EntryPointType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

GeographicEntityType

GeoJsonFeature

GeoJsonFeatureCollection

GeoJsonGeometry

GeoJsonGeometryCollection

GeoJsonLineString

GeoJsonMultiLineString

GeoJsonMultiPoint

GeoJsonMultiPolygon

GeoJsonPoint

GeoJsonPolygon

Geometry

LatLongPairAbbreviated

LocalizedMapView

MatchType

OperatingHours

OperatingHoursRange

OperatingHoursTime

OperatingHoursTimeRange

PointOfInterest

PointOfInterestCategorySet

QueryType

ResponseFormat

SearchAddressResult

SearchAddressResultItem

SearchAddressResultType

SearchIndexes

SearchInsideGeometryRequest

SearchSummary

Дополнительные ресурсы