Идентификаторы мест

Выберите платформу: Android iOS Веб-служба JavaScript

Идентификаторы мест однозначно идентифицируют место в базе данных Google Адресов и на Картах Google. Идентификаторы мест принимаются в запросах к следующим API Карт:

  • Получение адреса для идентификатора места в веб-службе Geocoding API и службе геокодирования Maps JavaScript API.
  • Указание пунктов отправления, назначения и промежуточных путевых точек в веб-службе Routes API и Directions API, а также в службе Directions API JavaScript Maps.
  • Указание пунктов отправления и назначения в API маршрутов и веб-службе API матрицы расстояний, а также в службе матрицы расстояний, API JavaScript Карт.
  • Получение сведений о месте в веб-службе Places API, Places SDK для Android, Places SDK для iOS и библиотеке Places.
  • Использование параметров Place ID в Maps Embed API.
  • Получение поисковых запросов в URL-адресах Карт.
  • Отображение ограничений скорости в Roads API.
  • Поиск и стилизация граничных полигонов в стиле границ на основе данных.

Найти идентификатор определенного места

Вы ищете идентификатор конкретного места? Воспользуйтесь поиском идентификатора места ниже, чтобы найти место и получить его идентификатор:

Кроме того, вы можете просмотреть поиск по идентификатору места с его кодом в документации Maps JavaScript API.

Обзор

Идентификатор места — это текстовый идентификатор, который однозначно идентифицирует место. Длина идентификатора может варьироваться (максимальная длина для идентификаторов мест не установлена). Примеры:

  • ChIJgUbEo8cfqokR5lP9_Wh_DaM
  • GhIJQWDl0CIeQUARxks3icF8U8A
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0EiGhIYChQKEgnRTo6ixx-qiRHo_bbmkCm7ZRAN
  • EicxMyBNYXJrZXQgU3QsIFdpbG1pbmd0b24sIE5DIDI4NDAxLCBVU0E
  • IhoSGAoUChIJ0U6OoscfqokR6P225pApu2UQDQ

Идентификаторы мест доступны для большинства мест, включая предприятия, достопримечательности, парки и перекрестки. Одно и то же место или местоположение может иметь несколько разных идентификаторов мест. Идентификаторы мест могут со временем меняться.

Вы можете использовать один и тот же идентификатор места в API Places и в ряде API платформы Google Maps. Например, вы можете использовать один и тот же идентификатор места для ссылки на место в Places API , Maps JavaScript API , Geocoding API , Maps Embed API и Roads API .

Получить сведения о месте, используя идентификатор места

Распространенный способ использования идентификаторов мест – поиск места (например, с помощью Places API или библиотеки Places в Maps JavaScript API), а затем использование возвращенного идентификатора места для получения сведений о месте. Вы можете сохранить идентификатор места и использовать его для последующего получения тех же сведений о месте. О сохранении идентификаторов мест читайте ниже.

Пример использования библиотеки Places в Maps JavaScript API

Чтобы использовать идентификатор места в своем приложении JavaScript, вы должны сначала найти идентификатор, который доступен в PlaceResult , возвращаемом поиском места , или с помощью getPlace() в службе Place Autocomplete . Затем вы можете использовать идентификатор места для поиска сведений о нем .

var map;

function initialize() {
  // Create a map centered in Pyrmont, Sydney (Australia).
  map = new google.maps.Map(document.getElementById('map'), {
    center: {lat: -33.8666, lng: 151.1958},
    zoom: 15
  });

  // Search for Google's office in Australia.
  var request = {
    location: map.getCenter(),
    radius: '500',
    query: 'Google Sydney'
  };

  var service = new google.maps.places.PlacesService(map);
  service.textSearch(request, callback);
}

// Checks that the PlacesServiceStatus is OK, and adds a marker
// using the place ID and location from the PlacesService.
function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    var marker = new google.maps.Marker({
      map: map,
      place: {
        placeId: results[0].place_id,
        location: results[0].geometry.location
      }
    });
  }
}

google.maps.event.addDomListener(window, 'load', initialize);

Сохраняйте идентификаторы мест для дальнейшего использования.

На идентификаторы мест не распространяются ограничения кэширования, указанные в разделе 3.2.3(b) Условий использования платформы Google Maps. Таким образом, вы можете сохранить значения идентификаторов мест для дальнейшего использования.

Обновление сохраненных идентификаторов мест.

Мы рекомендуем обновить идентификаторы мест, если им больше 12 месяцев. Идентификаторы мест можно обновить бесплатно , отправив запрос сведений о месте , указав только поле place_id в параметре fields . Этот вызов запускает SKU «Сведения о местах — обновление идентификатора» .

Этот запрос также может возвращать код состояния NOT_FOUND . Одна из стратегий — сохранить исходный запрос, который вернул идентификатор каждого места. Если идентификатор места станет недействительным, вы можете повторно отправить запрос, чтобы получить новые результаты. Эти результаты могут включать или не включать исходное место. Однако этот запрос является платным.

Коды ошибок при использовании идентификаторов мест

Код состояния INVALID_REQUEST указывает, что указанный идентификатор места недействителен. INVALID_REQUEST может быть возвращен, если идентификатор места был усечен или изменен иным образом и больше не является правильным.

Код состояния NOT_FOUND указывает, что указанный идентификатор места устарел. Идентификатор места может устареть, если компания закроется или переедет в новое место. Идентификаторы мест могут измениться из-за масштабных обновлений базы данных Google Maps. В таких случаях место может получить новый идентификатор места, а старый идентификатор вернет ответ NOT_FOUND .

В частности, некоторые типы идентификаторов мест могут иногда вызывать ответ NOT_FOUND , или API может возвращать в ответе другой идентификатор места. К этим типам идентификаторов мест относятся:

  • Уличные адреса, которые не существуют в Картах Google как точные адреса, но выводятся из диапазона адресов.
  • Участки длинного маршрута, где в запросе также указан город или населенный пункт.
  • Перекрестки.
  • Места с адресным компонентом типа subpremise .

Эти идентификаторы часто имеют форму длинной строки (для идентификаторов мест не существует максимальной длины). Например:

EpID4LC14LC_4LCo4LCv4LGN4LCo4LCX4LCw4LGNIC0g4LC44LGI4LCm4LGN4LCs4LC-4LCm4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSAmIOCwteCwv-CwqOCwr-CxjSDgsKjgsJfgsLDgsY0g4LCu4LGG4LCv4LC_4LCo4LGNIOCwsOCxi-CwoeCxjeCwoeCxgSwg4LC14LC_4LCo4LCv4LGNIOCwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwsuCwleCxjeCwt-CxjeCwruCwv-CwqOCwl-CwsOCxjSDgsJXgsL7gsLLgsKjgsYAsIOCwuOCwsOCxguCwsOCxjSDgsKjgsJfgsLDgsY0g4LC14LGG4LC44LGN4LCf4LGNLCDgsLjgsK_gsYDgsKbgsL7gsKzgsL7gsKbgsY0sIOCwueCxiOCwpuCwsOCwvuCwrOCwvuCwpuCxjSwg4LCk4LGG4LCy4LCC4LCX4LC-4LCjIDUwMDA1OSwg4LCt4LC-4LCw4LCk4LCm4LGH4LC24LCCImYiZAoUChIJ31l5uGWYyzsR9zY2qk9lDiASFAoSCd9ZebhlmMs7Efc2NqpPZQ4gGhQKEglDz61OZpjLOxHgDJCFY-o1qBoUChIJi37TW2-YyzsRr_uv50r7tdEiCg1MwFcKFS_dyy4