API DuckDuckGo Maps
DuckDuckGo Maps показывает места на карте на основе данных Apple Maps и рейтингов Yelp. search выдаёт места по ключевому слову вокруг центра карты, около 20 за вызов.
Параметры latitude и longitude обязательны. Каждая запись содержит apple_maps_id, который принимает действие places на странице Apple Maps для получения полных сведений о месте, а также часы работы по дням недели, уровень цен, рейтинг и несколько фрагментов отзывов без данных об авторах.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия DuckDuckGo Maps: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Поискsearch | Находите места на DuckDuckGo Maps по keyword вокруг обязательного центра карты. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API DuckDuckGo Maps?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
searchПоиск Находите места на DuckDuckGo Maps по | keyword, latitude, longitude | — | Режим выдачи: Sync | Значения в каталоге: defaultLimit=20, maxLimit=50. В некоторых действиях limit задаёт число страниц или число вложенных элементов на родительский объект, поэтому это не всегда итоговое количество записей. | $0.56 за 1 000 запросов | rank · name · apple_maps_id · yelp_id · category · address · city · country_code · timezone · lat · lng · phone · website · url · menu_url · rating · rating_scale · review_count · price · open_state · opening_hours · image_url · top_reviews · platform |
Что означают параметры действия search в API DuckDuckGo Maps?
Находите места на DuckDuckGo Maps по keyword вокруг обязательного центра карты. Получайте около 20 мест с Apple Maps ID, категорией, адресом, координатами, телефоном, сайтом, рейтингом Yelp и числом отзывов, уровнем цен, расписанием работы по дням недели и несколькими фрагментами отзывов.
keywordОбязательный- Что искать на карте: название места или категорию, например
coffeeилиmuseum.Справка DuckDuckGo: карты основаны на данных Apple — На странице справки DuckDuckGo сказано, что для поиска сервис использует несколько источников информации, а карты получает от Apple. Источник подтверждает только, что DuckDuckGo Maps использует картографические данные Apple, поэтому в записях есть Apple Maps ID; `keyword` в этом API ищет названия или категории мест вокруг заданного центра карты, а о количестве результатов, источниках рейтингов или полях с часами работы источник ничего не говорит. · Проверено latitudeОбязательный- Широта центра карты, от -90 до 90. Обязательный параметр; в результаты попадают места примерно в пределах одного экрана вокруг этой точки.
longitudeОбязательный- Долгота центра карты, от -180 до 180. Обязательный параметр.
Как использовать API DuckDuckGo 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":"duckduckgo_maps","action":"search","params":{"keyword":"<keyword>","latitude":"<latitude>","longitude":"<longitude>"}}'
Вопросы об API DuckDuckGo Maps
Какие данные можно получить через API DuckDuckGo Maps?
Укажите в platform значение duckduckgo_maps. В текущем каталоге: поиск. Эти названия действий соответствуют разным объектам или представлениям DuckDuckGo Maps; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса search к платформе DuckDuckGo Maps?
Что искать на карте: название места или категорию, например coffee или museum. Передайте это значение в поле keyword объекта params.
Какие поля может вернуть search на платформе DuckDuckGo Maps?
Объявленная схема включает rank, name, apple_maps_id и yelp_id. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия DuckDuckGo Maps возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.