Спецификация HTTPS

HTTPS — один из доступных форматов для передачи данных ELS от мобильного устройства к конечному устройству. Протокол HTTPS является стандартным, и в этом документе подробное описание самого протокола не предусмотрено. Конечные устройства должны получать POST-сообщения, содержащие информацию о местоположении в экстренных ситуациях в следующих полях.

Note that a best effort attempt should be made to populate as many fields as possible when the data is available, in particular, the following fields: time , location_latitude , location_longitude and location_accuracy . ELS messages are of little use without such data. However, in the end, every field is considered optional. The endpoint should generally be able to handle messages with missing/malformed fields without errors.

При успешном получении сообщения конечные точки должны возвращать коды успеха 2XX. Если возникает проблема с обработкой сообщения или сообщение необходимо отбросить по другим причинам, конечные точки все равно должны возвращать код успеха 2XX. Для отслеживания конкретной обработки сообщения конечной точкой могут использоваться разные коды успеха 2XX.

Формат данных основан на последней спецификации ETSI AML . Наиболее актуальны следующие разделы:

Содержание

Спецификация поля

Ключ Ценить Единицы Пример
v Версия - 1
emergency_number Набран номер экстренной службы - 911
source Источник активации (звонок, SMS) - ВЫЗОВ
thunderbird_version Version number for thunderbird module - 2800
time Отметка времени начала звонка ms (unix time) 1438101600123
location_latitude Широта градусы 37.4217845
location_longitude Долгота градусы -122.0847413
location_time Отметка времени определения местоположения мс (время Unix) 1438102600123
location_altitude Высота (WGS84) метры 4
location_altitude_msl Altitude (mean sea level) метры 4
location_floor Надпись на этаже (как на кнопке лифта — может быть нецифровой) - 2
location_source Источник местоположения (GPS, Wi-Fi, сотовая связь, неизвестно) - GPS
location_accuracy Точность метры 20
location_vertical_accuracy Вертикальная точность метры 2.5
location_vertical_accuracy_msl Вертикальная точность (средний уровень моря) метры 2.5
location_confidence Уверенность в точности определения местоположения Percent (0-1) 0.6827
location_bearing Несущий градусы 156.7
location_speed Скорость meters/second 1.2
device_number Номер телефона устройства (по возможности отформатирован в формате E.164) - +1438101600
device_model Модель устройства (обычно указывается в формате «производитель устройства», за которым следует название модели устройства»). - Motorola Nexus 6
device_imsi ИМСИ - 310260579377451
device_imei ИМЕЙ - 355458061005220
device_iccid ИКЦИД - 89148000001466362977
cell_home_mcc Главная MCC - 310
cell_home_mnc Главная MNC - 260
cell_network_mcc Сеть MCC - 310
cell_network_mnc Сетевая транснациональная корпорация - 260
hmac Код аутентификации сообщения -

Нулевое местоположение

Номер устройства

The device_number field may not always be specified in some cases. ELS will attempt to acquire the phone number from a variety of sources but it may not be possible. We recommend: sending a SMS message in addition to an HTTPS message and matching by IMEI and time (timestamp of beginning of call) on receiving both to infer the device number, or working with MNOs to retrieve phone numbers using IMEI/IMSI.

По возможности мы стараемся форматировать номер в формате E.164, используя знак плюса и префикс кода страны, за которым следует номер абонента без пробелов и скобок +1438101600 . В тех случаях, когда мы не можем определить код страны и, следовательно, не можем отформатировать номер, мы отправим исходный номер, предоставленный источником.

Altitude Elevation (Z-axis)

ELS сообщает координаты по оси Z во всех HTTPS-сообщениях о местоположении, доставляемых на конечную точку ELS. Высота указывается как в метрах над уровнем моря (MSL): location_altitude_msl , так и в метрах над опорным эллипсоидом WGS84: location_altitude (WGS — это опорная мировая геодезическая система, используемая GPS).

ELS also reports vertical accuracy for both altitude measurements in meters: location_vertical_accuracy and location_vertical_accuracy_msl . Vertical accuracy is defined the same as location accuracy and the confidence percentile is set by the partner. The default is set at 68% confidence. More information is available in the Android documentation for getVerticalAccuracyMeters() and getMslAltitudeAccuracyMeters() .

Благодаря возможности определения высоты пользователя над уровнем моря (MSL) с помощью серверных API можно получить высоту местности над уровнем моря и, таким образом, определить высоту пользователя над землей.

Дополнительная информация для экстренных случаев

Система ELS поддерживает поля, выходящие за рамки определения местоположения, которые в совокупности называются дополнительной информацией для экстренных случаев (AEI). Эти поля не предоставляются по умолчанию и сгруппированы в четыре категории, для каждой из которых требуется явное согласие партнера:

  • Общие сведения (язык устройства, тип чрезвычайной ситуации, информация о триггерах экстренного вызова, включая временные метки обнаружения ДТП и падения)
  • Медицинская информация
  • Контакты для экстренной связи
  • Прямая трансляция видео

Для включения этих полей отправьте запрос на изменение конфигурации или свяжитесь с командой ELS в случае возникновения вопросов.

Ограничения и соображения

This data may or may not be current or accurate. Medical information and emergency contacts are sourced from the emergency app on the user's device. This app is provided by the phone manufacturer, and it's up to them to decide which information they support, and whether they provide information formatted or free-form. In addition, this data is entered directly by the user. Generally this data must be sanitized.

Для полей произвольной формы («строки») данные передаются системой ELS без изменений, поэтому нет никаких гарантий относительно формата или достоверности. Для структурированных полей ELS отправляет их значение в определенном формате, но не дает никаких гарантий относительно достоверности этих данных. Примеры:

  • Временные метки: Гарантируется, что это число, и ожидается, что оно будет содержать миллисекунду с момента начала эпохи UNIX для реализаций, соответствующих спецификации. Должна быть возможность корректной обработки недопустимых значений (например -1 ) для реализаций, не соответствующих спецификации.
  • Даты: Гарантируется соответствие формату ISO 8601 YYYY-MM-DD . Должна быть предусмотрена возможность корректной обработки недопустимых дат (например, 2020-22-22 ) в случае несоответствия реализации спецификации.

Общий

Ключ Ценить Единицы Пример
adr_carcrash_time Отметка времени автомобильной аварии мс (время Unix) 1438101600123
device_languages Языковые теги BCP 47 (разделенные запятыми), в порядке от наивысшего приоритета к наинизшему. - en-US,fr-FR
emergency_type Тип чрезвычайной ситуации, если он выбран пользователем во время вызова экстренной помощи. Одна из служб: медицина/пожарная служба/полиция ОГОНЬ
fall_detection_time Отметка времени, когда было обнаружено падение. мс (время Unix) 1438101600124
loss_of_pulse_time Отметка времени, когда было обнаружено событие потери импульса. мс (время Unix) 1438101600125

Контакты для экстренной связи

Ключ Ценить Единицы Пример
econtact_[0-12]_name Name of the [0-12]th emergency contact - Джон Доу
econtact_[0-12]_phone_number Номер телефона [0-12]-го контактного лица на случай чрезвычайной ситуации Номер телефона не гарантированно является действительным. +123 456789
econtact_[0-12]_relationship Отношения пользователя с [0-12]-м контактом для экстренной связи - Сестра

Медицинская информация

Ключ Ценить Единицы Пример
med_info_last_updated_time Отметка времени последнего обновления медицинской информации. мс (время Unix, достоверность не гарантируется) 1438101600124
med_info_name Имя пользователя - Алекс Смит
med_info_date_of_birth_gregorian Дата рождения ISO 8601 ГГГГ-ММ-ДД (дата может быть не гарантированно указана, например, 2020-22-22) 1990-01-03
med_info_date_of_birth_other Дата рождения (в произвольной форме) - On the first day of year 2000
med_info_height Высота - 180 см
med_info_weight Масса - 10 камней
med_info_sex Biological sex (predefined) Один из НЕИЗВЕСТНЫХ / МУЖСКОЙ / ЖЕНСКИЙ / ИНТЕРСЕКС / ДРУГОЙ ИНТЕРСЕКС
med_info_sex_extra Биологический пол (свободная форма, потенциально дополнительно к медицинской информации о поле) - Переход от женского пола к мужскому
med_info_gender Пол - небинарный
med_info_home_address Домашний адрес - 123 Галифакс-авеню,
Александрия 12345
med_info_blood_type_abo Группа крови (предопределенная) Один из UNKNOWN / O_POSITIVE / O_NEGATIVE / O_UNKNOWN / A_POSITIVE / A_NEGATIVE / A_UNKNOWN / B_POSITIVE / B_NEGATIVE / B_UNKNOWN / AB_POSITIVE / AB_NEGATIVE / AB_UNKNOWN / H_H B_NEGATIVE
med_info_blood_type_other Группа крови (в произвольной форме) - Ле(аб-)
med_info_allergies Аллергии - Латекс
med_info_medications Лекарственные препараты - Аспирин
med_info_conditions_history История заболеваний - Гипертония
med_info_devices_mobility_requirements Медицинские устройства или требования к мобильности - Кардиостимулятор
med_info_pregnancy_status Статус беременности One of UNKNOWN / PREGNANT / NOT_PREGNANT БЕРЕМЕННАЯ
med_info_pregnancy_due_date Предполагаемая дата родов ISO 8601 ГГГГ-ММ-ДД (дата может быть не гарантированно указана, например, 2020-22-22) 2022-10-10
med_info_pregnancy_info Информация о беременности Возможно, является дополнением к med_info_pregnancy_status и med_info_pregnancy_due_date Плановое кесарево сечение
med_info_organ_donor Organ donor (predefined) One of UNKNOWN / NO / YES ДА
med_info_organ_donor_extra Донор органов (в свободной форме) Возможно, является дополнением к med_info_organ_donor Только сердце и легкие
med_info_advanced_directives Advanced directives - DNS
med_info_physician_info Информация о лечащем враче - Джон Доу, улица Рейнбоу, 34, +123 456789
med_info_other Прочая медицинская информация - Застраховано частным образом, идентификационный номер страхового полиса 123-ABC-987

Прямая трансляция

ELS поддерживает потоковое видео, позволяющее инициировать видеопоток с устройства пользователя. Если эта функция включена, вы будете получать поле live_video_token в сообщениях HTTPS ELS, если телефон пользователя поддерживает эту функцию (Android 8+ Oreo). Дополнительную информацию см. в разделе «Потоковое видео» .

Ключ Ценить Единицы Пример
live_video_token 6 случайных заглавных буквенно-цифровых символов - ABC123

Примеры

No location, with device number (E. 164 format):

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643650654147&location_latitude=%2B00.00000&location_longitude=%2B000.00000&location_time=1643650654147&location_altitude=0&location_accuracy=0&location_confidence=0&location_source=unknown&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15

No location, no device number:

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643650654147&location_latitude=%2B00.00000&location_longitude=%2B000.00000&location_time=1643650654147&location_altitude=0&location_accuracy=0&location_confidence=0&location_source=unknown&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15

Местоположение вычислено с указанием номера устройства (формат E.164):

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15

Местоположение вычислено с указанием номера устройства (в формате, отличном от E.164):

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=01234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15

Местоположение вычислено, номер устройства отсутствует:

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15

Местоположение рассчитано, а также предоставлена ​​дополнительная информация для экстренных случаев:

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15&adr_carcrash_time=1643648829100&fall_detection_time=1643648829200&loss_of_pulse_time=1643648829201&emergency_type=MEDICAL

Местоположение вычислено с использованием видео в реальном времени:

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15&live_video_token=ABC123

Местоположение вычисляется с учетом медицинской информации и контактных данных для экстренной связи (при условии корректной работы приложения для экстренной связи, предоставляющего структурированные данные):

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15&med_info_name=Alex+Smith&med_info_date_of_birth_gregorian=1990-01-03&med_info_height=6+ft&med_info_weight=100+kg&med_info_home_address=Test+Street+5%2C+80636+Munich&med_info_blood_type_abo=H_H&med_info_allergies=Peanuts&med_info_medications=Zestril&med_info_pregnancy_status=PREGNANT&med_info_pregnancy_due_date=2023-10-31&med_info_organ_donor=YES&med_info_other=Insurance+id%3A+12345

Местоположение вычисляется с учетом медицинской информации и контактных данных для экстренной связи (при условии корректной работы приложения для экстренной связи, предоставляющего неструктурированные данные и задающего все возможные поля):

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15&med_info_last_updated_time=1438101600000&med_info_name=Alex+Smith&med_info_date_of_birth_other=On+the+first+day+of+year+2000&med_info_height=180+cm&med_info_weight=10+stones&med_info_sex=INTERSEX&med_info_sex_extra=Transitioning+from+FEMALE+to+MALE&med_info_gender=non-binary&med_info_home_address=123+Halifax+Avenue%2C+Alexandria+12345&med_info_blood_type_other=Le%28a-b-%29&med_info_allergies=Latex&med_info_medications=Aspirin&med_info_conditions_history=ADHD&med_info_devices_mobility_requirements=Pacemaker&med_info_pregnancy_status=PREGNANT&med_info_pregnancy_due_date=2022-10-10&med_info_pregnancy_info=Planned+c-section&med_info_organ_donor=YES&med_info_organ_donor_extra=Only+heart+and+lungs&med_info_advanced_directives=DNS&med_info_physician_info=John+Doe%2C+34+Rainbow+street%2C+%2B123+456789&med_info_other=Privately+insured%2C+insurance+ID+123-ABC-987&econtact_0_name=John+Doe&econtact_0_phone_number=000+000&econtact_0_relationship=Father&econtact_1_name=Jane+Doe&econtact_1_phone_number=111+111&econtact_1_relationship=Mother&econtact_2_name=Alice+Smith&econtact_2_phone_number=222+222&econtact_2_relationship=Sister&econtact_3_name=Bob+Smith&econtact_3_phone_number=333+333&econtact_3_relationship=Brother&econtact_4_name=Charlie+Smith&econtact_4_phone_number=444+444&econtact_4_relationship=Brother&econtact_5_name=Dan+Smith&econtact_5_phone_number=555+555&econtact_5_relationship=Cousin&econtact_6_name=Eve+Smith&econtact_6_phone_number=666+666&econtact_6_relationship=Grandmother&econtact_7_name=Mallory+Smith&econtact_7_phone_number=777+777&econtact_7_relationship=Aunt&econtact_8_name=Trent+Smith&econtact_8_phone_number=888+888&econtact_8_relationship=Uncle&econtact_9_name=Xenia+Smith&econtact_9_phone_number=999+999&econtact_9_relationship=Sister&econtact_10_name=Yara+Smith&econtact_10_phone_number=10+10+10&econtact_10_relationship=Cousin&econtact_11_name=Zane+Smith&econtact_11_phone_number=11+11+11&econtact_11_relationship=Cousin&econtact_12_name=%28truncated%29

Местоположение вычислено с использованием медицинской информации (при условии, что в худшем случае приложение для экстренной помощи предоставит некорректные, неограниченные и неструктурированные данные):

v=1&thunderbird_version=220512054&emergency_number=911&source=CALL&time=1643648829301&location_latitude=51.5332125&location_longitude=-0.1260139&location_time=1643648838875&location_altitude=77.5999985&location_altitude_msl=67.5999985&location_vertical_accuracy=0.9868233&location_vertical_accuracy_msl=0.8868233&location_accuracy=14.9460001&location_bearing=306.3276367&location_speed=0.0783991&location_confidence=0.6826895&location_source=wifi&device_number=%2B1234567890&device_model=Google+Pixel+6+Pro&device_imei=123456789012345&device_imsi=234159876543210&device_iccid=12345678901234567890&cell_home_mcc=234&cell_home_mnc=15&cell_network_mcc=234&cell_network_mnc=15&med_info_last_updated_time=-1000&med_info_date_of_birth_gregorian=0000-00-00&med_info_sex_extra=Transitioning+from+FEMALE+to+MALE&med_info_blood_type_other=Le%28a-b-%29&med_info_pregnancy_due_date=3000-22-22&med_info_organ_donor_extra=Only+heart+and+lungs&med_info_other=Lorem+ipsum+dolor+sit+amet%2C+consetetur+sadipscing+elitr%2C+sed+diam+nonumy+eirmod+tempor+invidunt+ut+labore+et+dolore+magna+aliquyam+erat%2C+sed+diam+voluptua.+At+vero+eos+et+accusam+et+justo+duo+dolores+et+ea+rebum.+Stet+clita+kasd+gubergren%2C+no+sea+takimata+sanctus+est+Lorem+ipsum+dolor+sit+amet.+Lorem+ipsum+dolor+sit+amet%2C+consetetur+sadipscing+elitr%2C+sed+diam+nonumy+eirmod+tempor+invidunt+ut+labore+et+dolore+magna+aliquyam+erat%2C+sed+diam+voluptua.+At+vero+eos+et+accusam+et+justo+duo+dolores+et+ea+rebum.+Stet+clita+kasd+gubergren%2C+no+sea+takimata+sanctus+est+Lorem+ipsum+dolor+sit+amet.+Lorem+ipsum+dolor+sit+amet%2C+consetetur+sadipscing+elitr%2C+sed+diam+nonumy+eirmod+tempor+invidunt+ut+labore+et+dolore+magna+aliquyam+erat%2C+sed+diam+voluptua.+At+vero+eos+et+accusam+et+justo+duo+dolores+et+ea+rebum.+Stet+clita+kasd+gubergren%2C+no+sea+takimata+sanctus+est+Lorem+ipsum+dolor+sit+amet.+%0A%0ADuis+autem+vel+eum+iriure+dolor+in+hendrerit+in+vulputate+velit+esse+molestie+consequat%2C+vel+illum+dolore+eu+feugiat+nulla+facilisis+at+vero+eros+et+accumsan+et+iusto+odio+dignissim+qui+blandit+praesent+luptatum+zzril+delenit+augue+duis+dolore+te+feugait+nulla+facilisi.+Lorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit%2C+sed+diam+nonummy+nibh+euismod+tincidunt+ut+laoreet+dolore+magna+aliquam+erat+volutpat.+%0A%0AUt+wisi+enim+ad+minim+veniam%2C+quis+nostrud+exerci+tation+ullamcorper+suscipit+lobortis+nisl+ut+aliquip+ex+ea+commodo+consequat.+Duis+autem+vel+eum+iriure+dolor+in+hendrerit+in+vulputate+velit+esse+molestie+consequat%2C+vel+illum+dolore+eu+feugiat+nulla+facilisis+at+vero+eros+et+accumsan+et+iusto+odio+dignissim+qui+blandit+praesent+luptatum+zzril+delenit+augue+duis+dolore+te+feugait+nulla+facilisi.+%0A%0ANam+liber+tempor+cum+soluta+nobis+eleifend+option+congue+nihil+imperdiet+doming+id+quod+mazim+placerat+facer+possim+assum.+Lorem+ipsum+dolor+sit+amet%2C+consectetuer+adipiscing+elit%2C+sed+diam+nonummy+nibh+euismod+tincidunt+ut+laoreet+dolore+magna+aliquam+erat+volutpat.+Ut+wisi+enim+ad+minim+v%28truncated%29