RU:Key:panoramax
 panoramax
|
 |
| Описание |
|---|
Идентификатор изображения для панорамного снимка. 
|
| Группа: references |
| Веб-сайт |
| api.panoramax.xyz |
| URL шаблон |
| https://api.panoramax.xyz/#focus=pic&pic=$1 |
| Используется на элементах |
    |
| Статус: де-факто |
| Инструменты |
|
Параметр panoramax=* используется для создания ссылки с объекта OSM на изображение этого объекта в Panoramax, открытой и объединенной платформе для получения изображений с уровня улицы. В качестве значения используется уникальный идентификатор изображения (UUID).
Этот UUID можно найти в программе просмотра изображений Panoramax, нажав кнопку 🮦 в левом верхнем углу экрана: На вкладке Summary есть раздел "Copy ID" с кнопкой "Picture", нажатие которой должно скопировать UUID в буфер обмена.
Значение
Для доступа к изображению достаточно UUID изображения, полученного путем запроса к метакаталогу Panoramax.
Пример: panoramax=cafb0ec8-51dd-43ac-836c-8cd1f7cb8725
- Прямой доступ к изображению в полном разрешении: https://api.panoramax.xyz/api/pictures/cafb0ec8-51dd-43ac-836c-8cd1f7cb8725/hd.jpg
- Прямой доступ к изображению низкого разрешения: https://api.panoramax.xyz/api/pictures/cafb0ec8-51dd-43ac-836c-8cd1f7cb8725/sd.jpg
- Прямой доступ к миниатюре изображения: https://api.panoramax.xyz/api/pictures/cafb0ec8-51dd-43ac-836c-8cd1f7cb8725/thumb.jpg
- Доступ к веб-просмотрщику: https://api.panoramax.xyz/#focus=pic&pic=cafb0ec8-51dd-43ac-836c-8cd1f7cb8725
- Доступ к метаданным изображения (включая ссылки на изображения в полном разрешении, низком разрешении и миниатюры): https://api.panoramax.xyz/api/search?ids=cafb0ec8-51dd-43ac-836c-8cd1f7cb8725
Несколько изображений
_-_The_Noun_Project.svg){kind=small}
К одному и тому же объекту можно добавить несколько изображений, добавив в ключ числовой суффикс, например, так::
panoramax=45e05bef-f4db-4862-8ac5-4c634e7a692epanoramax:1=71297cbc-8f63-491f-a4cb-1a59c2591f5apanoramax:2=da88fa5d-4816-4346-9a42-454615d7e726
Также можно встретить использование panoramax:0=* пока нет единого мнения о том, с чего начинать отсчет.
Некоторые пользователи указывают несколько идентификаторов panoramax в одном ключе panoramax=* с помощью разделителя значений в виде точки с запятой (но эта практика стала примерно на порядок менее популярной по состоянию на декабрь 2025 года). Например:
panoramax=23ff0d32-40ea-4a20-8067-f5031e81cbde;7c642565-3532-49ae-b3ea-5b666ae3f310
Сохранение ориентации и масштабирования
Если важно сохранить определённые параметры масштабирования и ориентации (например, для 360° изображений) или любые данные, кроме UUID, то:
Большинство людей используют универсальный атрибут image=*, указывающий на полный URL-адрес, который наиболее широко поддерживается потребителями данных, не нарушает синтаксис panoramax=* и на порядок популярнее, чем сомнительная альтернатива, приведенная ниже. Например:
image=https://api.panoramax.xyz/#focus=pic&map=20/45.76535/4.75158&pic=d786319e-50f7-445f-bf2b-c2724815266d&speed=250&xyz=199.22/-5.88/30)
Обратите внимание, что некоторые добавляют параметры масштабирования/угла после UUID (как это используется в текущем URL веб-сайта), но такой подход ненадежен, гораздо менее популярен, менее поддерживается и не рекомендуется авторами Panoramax - но это выглядело бы, например, так:
panoramax=620cae1c-d2a1-4b7a-ac79-4d47ed7dc0f5&xyz=250.10/7.54/75
См. также
- Panoramax
image=*- универсальный ключ для указания ссылки на изображениеmapillary=*- изображения, доступные на Mapillarywikimedia_commons=*- Условные обозначения для категории или изображения на wikimedia commons- Photo linking - Создайте связи между функциями OSM и внешними изображениями