Все готово!

Прежде чем приступить к разработке, ознакомьтесь с документацией для разработчиков.

Активировать Google Maps Roads API

Чтобы помочь вам освоиться, мы покажем, как выполнить некоторые необходимые действия в консоли разработчика Google:

  1. Создание или выбор проекта
  2. Активировать Google Maps Roads API
  3. Создание соответствующих ключей

Ограничения скорости

Примечание. Служба ограничения скорости доступна только для клиентов Google Maps APIs Premium Plan с лицензией на Asset Tracking.

Google Maps Roads API возвращает установленное ограничение скорости для определенного участка дороги. Если для каких-то участков дороги действуют переменные ограничения скорости, возвращается ограничение скорости, заданное по умолчанию.

Точность данных об ограничении скорости, предоставленных Google Maps Roads API, не гарантируется. Данные об ограничении скорости предоставляются не в режиме реального времени, а значит могут быть приблизительными, неточными, неполными и/или устаревшими. О неточных данных можно сообщить с помощью службы Google Map Maker.

Запросы

Запрос ограничений скорости необходимо направлять по протоколу HTTPS в следующей форме:

https://roads.googleapis.com/v1/speedLimits?parameters&key=YOUR_API_KEY

Использование параметров

Обязательные параметры

  • Укажите параметр path или один либо несколько идентификаторов placeId.
    • path – путь, который требуется переложить. Параметр path допускает передачу списка, состоящего из парных значений координат широты/долготы. Значения широты и долготы должны быть разделены запятыми. Отдельные пары координат должны разделяться вертикальной чертой: "|". Например: path=60.170880,24.942795|60.170879,24.942796|60.170877,24.942796.
    • placeId – идентификатор места для участка дороги. Идентификаторы мест возвращаются в ответ на запросы snapToRoads и nearestRoads. В каждом запросе можно передать до 100 идентификаторов placeId.
  • key – ключ API вашего приложения. Приложение должно выполнять автоматическую аутентификацию при каждой отправке запроса в Google Maps Roads API, указывая ключ API в каждом запросе. См. дополнительную информацию о получении ключа.

Дополнительные параметры

  • units – выбор единиц для отображения ограничений скорости, в километрах или милях в час. Необходимо установить значение KPH или MPH. По умолчанию установлено KPH (мили в час).

Можно запросить данные об ограничении скорости с помощью параметра path или серии идентификаторов placeId; но для каждого уникального placeId в запросе будет предоставлен только один ответ. Если для короткого маршрута установлено множество точек, некоторые идентификаторы placeId могут повторяться.

Ответы

В ответе службы speedLimits могут содержаться следующие элементы.

  • speedLimits – массив метаданных дороги. Каждый такой элемент состоит из следующих полей.
    • placeId – уникальный идентификатор места. Все идентификаторы placeId, возвращенные Google Maps Roads API, будут соответствовать участкам дороги.
    • speedLimit – установленное ограничение скорости для участка дороги.
    • units – возвращает результат в KPH или MPH.
  • snappedPoints – массив привязанных точек. Данный массив отображается, если запрос содержит параметр path. Каждая точка состоит из следующих полей.
    • location – содержит значение latitude и longitude.
    • originalIndex – целое число, обозначающее соответствующее значение в исходном запросе. Каждое значение в запросе должно быть сопоставлено с привязанным значением в ответе. Данные значения индексируются от 0, поэтому точка с originalIndex равным 4 будет привязана к 5-му значению координат ширины/долготы, переданному в параметр path.
    • placeId – уникальный идентификатор места. Все идентификаторы placeId, возвращенные Google Maps Roads API, будут соответствовать участкам дороги. В запросе ограничения скорости можно передавать placeId для определения ограничения скорости на этом участке дороги.

Пример запроса

В следующем запросе будут определены ограничения скорости для короткого участка дороги в г. Канберра, Австралия.

Запрос

https://roads.googleapis.com/v1/speedLimits?placeId=ChIJ1Wi6I2pNFmsRQL9GbW7qABM
        &placeId=ChIJ58xCoGlNFmsRUEZUbW7qABM
        &placeId=ChIJ9RhaiGlNFmsR0IxAbW7qABM
        &placeId=ChIJabjuhGlNFmsREIxAbW7qABM
        &placeId=ChIJcSAlFWpNFmsRMHlUbW7qABM
        &placeId=ChIJI2FUTGhNFmsRcHpAbW7qABM
        &placeId=ChIJiy6YT2hNFmsRkHZAbW7qABM
        &placeId=ChIJoR7CemhNFmsRQB9QbW7qABM
        &placeId=ChIJP2m_FWpNFmsRIHlUbW7qABM
        &placeId=ChIJtV7La2pNFmsRAGpHbW7qABM
        &placeId=ChIJW5JAZmpNFmsRegG0-Jc80sM
        &placeId=ChIJW9R7smlNFmsRMH1AbW7qABM
        &placeId=ChIJy8c0r2lNFmsRQEZUbW7qABM
        &key=YOUR_API_KEY

Ответ

{
  "speedLimits": [
    {
      "placeId": "ChIJ1Wi6I2pNFmsRQL9GbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ58xCoGlNFmsRUEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJ9RhaiGlNFmsR0IxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJabjuhGlNFmsREIxAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJcSAlFWpNFmsRMHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJI2FUTGhNFmsRcHpAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJiy6YT2hNFmsRkHZAbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJoR7CemhNFmsRQB9QbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJP2m_FWpNFmsRIHlUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJtV7La2pNFmsRAGpHbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW5JAZmpNFmsRegG0-Jc80sM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJW9R7smlNFmsRMH1AbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    },
    {
      "placeId": "ChIJy8c0r2lNFmsRQEZUbW7qABM",
      "speedLimit": 60,
      "units": "KPH"
    }
  ]
}

Оставить отзыв о...

Текущей странице
Google Maps Roads API
Google Maps Roads API
Нужна помощь? Обратитесь в службу поддержки.