API Bing Maps
Bing Maps — картографический сервис Microsoft. search находит организации по ключевому слову вокруг центра карты и возвращает для каждой название, адрес, координаты, телефон, сайт, категорию, статус работы и рейтинг.
Укажите latitude и longitude нужной области; без них Bing выберет местоположение сам. Рейтинги и число отзывов обычно берутся с сайтов отзывов, например Yelp или TripAdvisor; название сайта указано в rating_source. Для пагинации используйте page; на каждой странице возвращается до 30 организаций.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Bing Maps: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите компании на Bing Maps по keyword вокруг центра карты. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Bing Maps?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите компании на Bing Maps по | keyword | language, latitude, longitude, page | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=30. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | rank · place_id · name · url · category · address · lat · lng · phone · website · rating · rating_scale · review_count · rating_source · open_state · hours_text · image_url · platform |
Что означают параметры действия search в API Bing Maps?
Находите компании на Bing Maps по keyword вокруг центра карты. Получайте ID компании в Bing, адрес, координаты, телефон, сайт, категорию, информацию о том, открыта ли она сейчас, а также рейтинг и число отзывов с таких сайтов, как Yelp или TripAdvisor. До 30 компаний на страницу.
keywordОбязательный- Что искать на карте: название компании или категорию, например
coffeeилиpizza. languageНеобязательный- Двухбуквенный код языка возвращаемых карточек организаций, например
enилиde. latitudeНеобязательный- Широта центра карты, от -90 до 90; задаётся вместе с
longitude. Без центра Bing выбирает местоположение сам, и это может оказаться не тот город, который вам нужен.Microsoft Learn: Bing Maps Local Search находит компании рядом с заданным местом — Согласно документации Microsoft, Bing Maps Local Search принимает запрос вместе с местоположением пользователя, ограничивающей рамкой или кругом и возвращает компании вокруг этого места; этот официальный интерфейс больше недоступен для бесплатных аккаунтов и охватывает только компании в США. Источник подтверждает только, что Bing Maps ищет компании по местоположению на карте; `latitude` и `longitude` в этом API задают центр карты, определённый EveryInfra, не относятся к тому официальному интерфейсу, и его региональное ограничение на них не распространяется. · Проверено longitudeНеобязательный- Долгота центра карты, от -180 до 180; задаётся вместе с
latitude. pageНеобязательный- Номер страницы с карточками организаций, начиная с 1; на странице
limitорганизаций (не более 20 страниц).
Как использовать API Bing Maps
- 01Выберите действие платформы в публичном каталоге.
- 02Передайте платформу, действие и обязательные параметры в POST-запросе на эндпоинт /api/v1/social.
- 03Получите результат из ответа. Для асинхронного действия опрашивайте статус по возвращённому ID задачи.
- 04Сохраните поля ответа, которые нужны вашему приложению.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"bing_maps","action":"search","params":{"keyword":"<keyword>"}}'
Вопросы об API Bing Maps
Какие данные можно получить через API Bing Maps?
Укажите в platform значение bing_maps. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям Bing Maps; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе Bing Maps?
Что искать на карте: название компании или категорию, например coffee или pizza. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе Bing Maps?
Объявленная схема включает rank, place_id, name и category. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Bing Maps возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.