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

Выберите платформу: 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

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

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

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

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

Пример использования Places SDK для Android

В Places SDK для Android вы можете получить идентификатор места, вызвав Place.getId() . Служба автозаполнения мест также возвращает идентификатор места для каждого места, которое соответствует предоставленному поисковому запросу и фильтру. Используйте идентификатор места, чтобы позже снова получить объект Place .

Чтобы получить место по идентификатору, вызовите PlacesClient.fetchPlace() , передав FetchPlaceRequest .

API возвращает FetchPlaceResponse в Task . FetchPlaceResponse содержит объект Place , соответствующий предоставленному идентификатору места.

В следующем примере кода показан вызов fetchPlace() для получения сведений об указанном месте.

Котлин 

// Define a Place ID.
val placeId = "INSERT_PLACE_ID_HERE"

// Specify the fields to return.
val placeFields = listOf(Place.Field.ID, Place.Field.NAME)

// Construct a request object, passing the place ID and fields array.
val request = FetchPlaceRequest.newInstance(placeId, placeFields)

placesClient.fetchPlace(request)
    .addOnSuccessListener { response: FetchPlaceResponse ->
        val place = response.place
        Log.i(PlaceDetailsActivity.TAG, "Place found: ${place.name}")
    }.addOnFailureListener { exception: Exception ->
        if (exception is ApiException) {
            Log.e(TAG, "Place not found: ${exception.message}")
            val statusCode = exception.statusCode
            TODO("Handle error with given status code")
        }
    }

Ява 

// Define a Place ID.
final String placeId = "INSERT_PLACE_ID_HERE";

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    Log.i(TAG, "Place found: " + place.getName());
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        final ApiException apiException = (ApiException) exception;
        Log.e(TAG, "Place not found: " + exception.getMessage());
        final int statusCode = apiException.getStatusCode();
        // TODO: Handle error with given status code.
    }
});

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

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

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

Мы рекомендуем обновить идентификаторы мест, если им больше 12 месяцев. Идентификаторы мест можно обновить бесплатно , отправив запрос сведений о месте , указав только поле Place.Field.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