API Apple Maps
Apple Maps — картографический сервис, встроенный в устройства Apple. places по числовым идентификаторам Apple Maps возвращает за один вызов данные не более чем о 50 местах. Для каждого места возвращаются адрес, координаты, телефон, сайт, категория, часы работы по дням недели, удобства, фото и данные рейтинга.
Идентификаторы мест можно взять из столбца apple_maps_id в результатах DuckDuckGo Maps или из auid в ссылке «Поделиться» Apple Maps. Рейтинги в Apple Maps часто берутся с партнёрских сайтов отзывов, поэтому в каждой записи сайт указан в rating_source. Вызов стоит одинаково для одного идентификатора и для пятидесяти.
Доступность платформы
- Состояние за 24 ч
- Норма
За последние 30 дней
Доступные возможности
Все действия Apple Maps: что делает каждое, сколько стоит и как работало за последние 24 часа. Откройте действие, чтобы увидеть параметры, поля ответа и примеры кода.
| Возможность | Описание | За 1000 | Состояние за 24 часа |
|---|---|---|---|
Сведения о местеplaces | Получайте до 50 мест Apple Maps за один вызов по их числовым ID. | $0.56 за 1 000 запросов | Норма |
Откройте возможность, чтобы посмотреть её параметры, поля ответа и примеры кода, а также попробовать её в работе.
Какие параметры принимает каждое действие API Apple Maps?
Каждый ответ ниже описывает одно вызываемое действие и его фактические входные данные. Значение параметров и допустимые значения зависят от действия: знакомое имя параметра не обязательно означает одно и то же на всех платформах.
Ссылки на официальные источники приводятся только для пояснения расположенного рядом термина, принятого на платформе. Они не означают, что платформа предоставила разрешение или выразила одобрение. Функции официального сайта не входят в API EveryInfra, если они не перечислены на этой странице.
| Действие | Обязательные | Необязательные | Способ получения результата | Лимит | За 1 000 | Поля ответа |
|---|---|---|---|---|---|---|
placesСведения о месте Получайте до 50 мест Apple Maps за один вызов по их числовым ID. В каждой записи есть адрес, координаты, телефон, сайт, категория, расписание работы по дням недели, удобства, фото, уровень цен, рейтинг с указанием сайта, откуда он взят, и несколько характерных отзывов. ID можно взять из результатов DuckDuckGo Maps или ссылки Apple Maps; один вызов стоит одинаково для одного ID и для пятидесяти. | place_ids | language | Режим выдачи: Sync | — | $0.56 за 1 000 запросов | place_id · name · url · category · categories · address · city · state · postal_code · country_code · lat · lng · timezone · phone · website · rating · rating_scale · review_count · rating_source · price · open_state · opening_hours · amenities · image_urls · top_reviews · is_claimed · platform |
Что означают параметры действия places в API Apple Maps?
Получайте до 50 мест Apple Maps за один вызов по их числовым ID. В каждой записи есть адрес, координаты, телефон, сайт, категория, расписание работы по дням недели, удобства, фото, уровень цен, рейтинг с указанием сайта, откуда он взят, и несколько характерных отзывов. ID можно взять из результатов DuckDuckGo Maps или ссылки Apple Maps; один вызов стоит одинаково для одного ID и для пятидесяти.
Полный справочник API: параметры, примеры кода, пример ответа и состояниеplace_idsОбязательный- Список из 1–50 числовых ID мест Apple Maps, например
["12971322601039101590"], из поляapple_maps_idзаписей DuckDuckGo Maps или параметраauidв ссылке Apple Maps. Вызов стоит одинаково для одного ID и для пятидесяти; ID, состоящие не только из цифр, отклоняются до списания средств.Apple Developer Documentation: как определять уникальные места с помощью Place ID — В документации Apple для разработчиков сказано, что Place ID на протяжении всего своего существования указывает на одну и ту же точку интереса и позволяет получить информацию об этом месте. Источник подтверждает только, что у мест в Apple Maps есть стабильные уникальные идентификаторы; `place_ids` в этом API — это числовые ID мест (auid) из ссылок Apple Maps, которые записываются иначе, чем буквенно-цифровые Place ID в MapKit, и не взаимозаменяемы с ними. Часы работы, удобства и поля рейтинга в источнике не описаны. · Проверено languageНеобязательный- Язык возвращаемых сведений о месте, например
en-US,zh-CNилиja-JP; подойдёт и двухбуквенный код вродеen. По умолчаниюen-US.
Как использовать API Apple 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":"apple_maps","action":"places","params":{"place_ids":"<place_ids>"}}'
Вопросы об API Apple Maps
Какие данные можно получить через API Apple Maps?
Укажите в platform значение apple_maps. В текущем каталоге: сведения о месте. Эти названия действий соответствуют разным объектам или представлениям Apple Maps; это не взаимозаменяемые режимы поиска.
Какие входные данные нужны для запроса places к платформе Apple Maps?
Список из 1–50 числовых ID мест Apple Maps, например ["12971322601039101590"], из поля apple_maps_id записей DuckDuckGo Maps или параметра auid в ссылке Apple Maps. Вызов стоит одинаково для одного ID и для пятидесяти; ID, состоящие не только из цифр, отклоняются до списания средств. Передайте это значение в поле place_ids объекта params.
Какие поля может вернуть places на платформе Apple Maps?
Объявленная схема включает place_id, name, category и categories. Объявленное поле может отсутствовать в отдельной записи, а у каждого другого действия свой список полей.
Все ли действия Apple Maps возвращают результат сразу?
Действия с пометкой «асинхронное» возвращают ID задачи, по которому нужно опрашивать статус. Любое другое действие тоже можно запустить асинхронно: добавьте "mode": "async" в тело запроса, чтобы сразу получить ID задачи. Это удобно для длительных задач или запросов с большим лимитом. В текущем каталоге: режим выдачи: sync.