Как очистить историю поездок — Cправка

Введение

Этот видеоролик иллюстрирует использование Google Maps Directions API для поиска маршрута. В видеоролике содержатся советы по защите ключа API путем проксирования веб-службы через ваш сервер при использовании API в мобильном приложении.

С помощью Directions API можно выполнять следующие действия.

  • Поиск комбинированных маршрутов, включающих общественный транспорт, поездки на автомобиле, перемещения пешком или на велосипеде.
  • Отображение маршрутов, состоящих из нескольких частей, с использованием наборов промежуточных точек маршрута.
  • Указание начальных, конечных и промежуточных точек в виде текстовых строк (например, «Chicago, IL» или «Darwin, NT, Australia»), в виде координат широты/долготы или в виде идентификаторов мест.

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

Примечание. Эта служба не предназначена для реагирования на ввод данных в режиме реального времени. Для расчета динамических маршрутов (например, в рамках элемента пользовательского интерфейса) обратитесь к документации Служба Google Maps JavaScript API Directions.

Перед началом разработки с использованием Directions API проверьте требования аутентификации (необходим ключ API) и лимиты использования API.

Подсказки мест – это функция библиотеки Places в Google Maps JavaScript API. Функцию подсказки мест можно добавить в приложение, чтобы оно выводило варианты названий мест при вводе текста в поле поиска Google Maps. Когда пользователь начинает вводить адрес, функция подсказки мест завершает ввод.

Что увидят другие пользователи

Все отзывы публикуются в открытом доступе и служат рекомендациями для других пользователей Google Карт. Оставлять анонимные отзывы нельзя.

Помимо самого отзыва, другие пользователи увидят:

  • ваше имя, указанное на странице О себе;
  • другие ваши отзывы на Google Картах;
  • фотографии, которые вы добавили на Google Карты.

Совет. Местные эксперты могут получать баллы за отзывы и оценки на Google Картах.

Начало работы

Перед использованием библиотеки Places в Google Maps JavaScript API убедитесь, что в консоли Google API Console включен Google Places API Web Service в том же проекте, который вы установили для Google Maps JavaScript API.

Чтобы просмотреть список включенных API:

  1. Перейдите в Google API Console.
  2. Нажмите кнопку Select a project, затем выберите тот же проект, который вы установили для Google Maps JavaScript API, и нажмите Open.
  3. В списке API на странице Dashboard найдите Google Places API Web Service.
  4. Если этот API присутствует в списке – все установлено. Если этого API в списке нет, включите его:
    1. Вверху страницы выберите ENABLE API, чтобы открыть вкладку Library. В качестве альтернативы можно выбрать пункт Library в меню слева.
    2. Найдите Google Places API Web Service и выберите его из списка результатов.
    3. Нажмите ENABLE. Когда процесс завершится, Google Places API Web Service появится в списке API на панели Dashboard.

Как просмотреть отзывы и оценки

Примечания

  • Google использует автоматизированные системы обнаружения спама, которые удаляют подозрительные отзывы. 
  • В Google запрещено публиковать ложные отзывы. Мы можем удалить любые отзывы, которые считаем ложными или которые не соответствуют нашим правилам.
  1. Откройте Google Карты на компьютере и войдите в аккаунт.
  2. Выполните поиск нужного места.
  3. В меню слева прокрутите вниз и нажмите Оставить отзыв.
  4. Поставьте нужное количество звезд в открывшемся окне. Вы также можете добавить отзыв.

Ваш отзыв будет отображаться в Google Картах, пока вы его не удалите. После публикации отзыва можно отредактировать его, изменить оценку и загрузить другие фотографии. 

Правила и ограничения на использование

На использование Google Places API Web Service и подсказок мест Google установлена единая квота, описанная на странице Ограничения на использование для Google Places API Web Service. Ограничения на использование также могут применяться при работе с Places Library in the Google Maps JavaScript API. Ежедневное использование рассчитывается как сумма запросов на стороне клиента и на стороне сервера.

Политики

Служба Places Library in the Google Maps JavaScript API должна использоваться в соответствии с правилами, описанными для Google Places API Web Service.

В этом видеоролике рассказывается об использовании виджета подсказки мест Autocomplete, а также демонстрируются примеры приложений и кода.

Краткий обзор классов

API содержит два типа виджетов подсказки мест, которые можно добавлять с помощью классов Autocomplete и SearchBox соответственно. Кроме того, вы можете использовать класс AutocompleteService для получения результатов подсказки мест программным способом.

Ниже приведена сводная информация по доступным классам:

  • Autocomplete – на веб-страницу добавляется поле текстового ввода и отслеживаются символы, вводимые в это поле. Когда пользователь начинает вводить текст, функция подсказки мест выводит подсказки в виде выпадающего списка. Когда пользователь выбирает место из списка, информация о соответствующем месте возвращается в объект подсказки мест, и ваше приложение может получить эту информацию. Подробные сведения см. ниже.
  • SearchBox – добавляет на веб-страницу поле текстового ввода, примерно так же, как и класс Autocomplete. Их отличия описаны ниже.
    • Основное отличие заключается в том, какие результаты выводятся в выпадающем списке. SearchBox выводит расширенный список подсказок, в который могут входить как места (в соответствии с определением Google Places API), так и предлагаемые фразы для поиска. Например, если пользователь вводит текст «Пицца в Северном», в списке подсказок может быть выведена фраза «пицца в Северном Измайлово», а также названия различных пиццерий.
    • Класс SearchBox имеет меньше параметров, ограничивающих результаты поиска, чем класс Autocomplete. В первом случае вы можете указать определенные границы (LatLngBounds) для ограничения результатов поиска. Во втором случае помимо границ вы можете ограничить результаты поиска определенной страной и определенным типом мест.

    Подробные сведения см. ниже.

  • Вы можете создать объект AutocompleteService для получения подсказок программным способом. Используйте вызов метода getPlacePredictions() для получения списка совпадающих мест или вызов метода getQueryPredictions() для получения списка совпадающих мест и предлагаемых фраз поиска. Примечание. Объект AutocompleteService не добавляет элементы управления пользовательского интерфейса. Вместо этого вышеуказанные методы возвращают массив объектов подсказок. Каждый объект подсказок содержит текст подсказки, а также справочную информацию и данные о том, как результат соответствует вводимым пользователем данным. Подробные сведения см. ниже.

Далее на этой странице приведены примеры и подробные данные по использованию вышеуказанных классов.

Как изменить настройки геолокации

  1. Откройте Google Карты на компьютере.

  2. В левом верхнем углу страницы нажмите на значок меню Меню.

  3. Нажмите Ваши впечатления дальше и затем выберите Отзывы.

  4. Рядом с нужным отзывом нажмите на значок «Ещё» Ещё.

  5. Выберите нужный вариант и следуйте инструкциям.

Если приложению требуются данные о вашем местоположении, вы увидите запрос.

Как пожаловаться на отзыв

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

  1. Откройте Google Карты на компьютере.
  2. Найдите отзыв, нарушающий наши правила.
  3. Рядом с отзывом нажмите на значок «Ещё» Ещё дальшеПожаловаться.

Добавление подсказки мест для мест и адресов

Содержит ли ваше приложение форму адреса, например, адрес доставки заказа через Интернет, адрес для выставления счета при оплате кредитной картой или форму заказа такси? Функция подсказки мест может упростить ввод данных.

Посмотрите, как работает заполнение формы адреса: Просмотр примера (places-autocomplete-addressform.html).

Далее вы можете узнать, как добавить функцию подсказки мест на веб-страницу.

Функция подсказки мест применяется для запрашивания информации у пользователей в приложении с картой, как показано на рисунке 3.

Посмотрите, как это работает: Просмотр примера (places-autocomplete-hotelsearch.html).

Класс Autocomplete создает на вашей веб-странице поле текстового ввода, выдает подсказки мест в списке пользовательского интерфейса и возвращает данные о месте в ответ на запрос getPlace(). Каждая запись в списке соответствует одному месту (в соответствии с определением Google Places API).

Конструктор Autocomplete принимает два аргумента:

  • HTML-элемент input типа text. Это поле ввода, которое отслеживает служба подсказки мест, и к которому она прикрепляет результаты.
  • Аргумент options, который может содержать следующие свойства:
    • Массив types, указывающий явный тип или коллекцию типов из числа перечисленных ниже. Если опустить этот параметр, в результатах поиска возвращаются все типы. Обычно разрешается только один тип. Исключение составляют типы geocode и establishment, которые можно указывать вместе, однако это равносильно отсутствию указанных типов. Поддерживаются следующие типы:
      • geocode – указывает службе Places, что возвращать нужно только результаты геокодирования, а не названия организаций.
      • address – ограничивает результаты поиска службы Places геокодами с точными адресами.
      • establishment – ограничивает результаты поиска службы Places организациями.
      • (regions) – групповое указание типа, которое ограничивает результаты поиска местами, соответствующими указанным ниже типам:
        • locality,
        • sublocality,
        • postal_code,
        • country,
        • administrative_area1,
        • administrative_area2.
      • (cities) – групповое указание типа, которое ограничивает результаты поиска местами с заданным значением locality или administrative_area3.
    • bounds – объект google.maps.LatLngBounds, указывающий область для поиска мест. В результатах отдается предпочтение местам из этой области, но они не ограничиваются этими местами.
    • componentRestrictions – может использоваться для ограничения результатов определенными группами. В настоящее время в качестве значения параметра componentRestrictions можно использовать только страны. Страна должна указываться в виде кода страны из двух символов, совместимого со стандартом ISO 3166-1 Alpha-2.
    • placeIdOnly можно использовать для того, чтобы дать виджету Autocomplete команду извлекать только идентификаторы мест. При вызове метода getPlace() для объекта Autocomplete, полученный PlaceResult будет иметь следующий набор свойств: place id, types и name. Возвращенный идентификатор места можно использовать в обращениях к службам Places, Geocoding, Directions и Distance Matrix.

Установка предпочтений и границ области поиска для подсказки мест

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

  • Установить границы при создании объекта Autocomplete.
  • Изменить границы существующего объекта Autocomplete.
  • Установить в качестве границы область просмотра карты.
  • Ограничить поиск определенной страной.

Более подробная информация приведена в разделах ниже.

SearchBox позволяет пользователям выполнять текстовый поиск в географическом контексте, например «пицца в Химках» или «обувной магазин на улице Ленина». Вы можете прикрепить объект SearchBox к текстовому полю, и во время ввода текста служба будет возвращать подсказки в виде выпадающего списка.

SearchBox выводит расширенный список подсказок, в который могут входить как места (в соответствии с определением Google Places API), так и предлагаемые фразы для поиска. Например, если пользователь вводит текст «Пицца в Северном», в списке подсказок может быть выведена фраза «пицца в Северном Измайлово», а также названия различных пиццерий.

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

Примечание. Когда пользователям отображаются подсказки в поле поиска Google Places, в них должен содержаться логотип Powered by Google. Для удобства разработчиков этот логотип добавляется в список результатов по умолчанию.

Конструктор SearchBox принимает два аргумента:

  • HTML-элемент input типа text. Это поле ввода, которое отслеживает служба SearchBox, и к которому она прикрепляет результаты.
  • Аргумент options, который может содержать свойство bounds. bounds – объект google.maps.LatLngBounds, указывающий область для поиска мест. В результатах отдается предпочтение местам из этой области, но они не ограничиваются этими местами.

Следующий фрагмент кода использует параметр bounds для ограничения результатов определенной географической областью, указываемой с помощью координат широты и долготы.

var defaultBounds = new google.maps.LatLngBounds(
  new google.maps.LatLng(-33.8902, 151.1759),
  new google.maps.LatLng(-33.8474, 151.2631));

var input = document.getElementById('searchTextField');

var searchBox = new google.maps.places.SearchBox(input, {
  bounds: defaultBounds
});

Изменение области поиска для объекта SearchBox

Чтобы изменить область поиска для существующего объекта SearchBox, нужно вызвать метод setBounds() для объекта SearchBox и передать в него соответствующий объект LatLngBounds.

Просмотр примера (places-searchbox.html).

Получение информации объекта SearchBox

Когда пользователь выбирает место из подсказок, прикрепленных к полю поиска, служба создает событие places_changed. Вы можете вызвать метод getPlace() для объекта SearchBox, чтобы получить массив, содержащий несколько подсказок, каждая из которых представляет собой объект PlaceResult.

Дополнительную информацию об объекте PlaceResult см. в документации по результатам запроса данных о месте.

// Listen for the event fired when the user selects a prediction and retrieve
// more details for that place.
searchBox.addListener('places_changed', function() {
  var places = searchBox.getPlaces();

  if (places.length == 0) {
    return;
  }

  // Clear out the old markers.
  markers.forEach(function(marker) {
    marker.setMap(null);
  });
  markers = [];

  // For each place, get the icon, name and location.
  var bounds = new google.maps.LatLngBounds();
  places.forEach(function(place) {
    if (!place.geometry) {
      console.log("Returned place contains no geometry");
      return;
    }
    var icon = {
      url: place.icon,
      size: new google.maps.Size(71, 71),
      origin: new google.maps.Point(0, 0),
      anchor: new google.maps.Point(17, 34),
      scaledSize: new google.maps.Size(25, 25)
    };

    // Create a marker for each place.
    markers.push(new google.maps.Marker({
      map: map,
      icon: icon,
      title: place.name,
      position: place.geometry.location
    }));

    if (place.geometry.viewport) {
      // Only geocodes have viewport.
      bounds.union(place.geometry.viewport);
    } else {
      bounds.extend(place.geometry.location);
    }
  });
  map.fitBounds(bounds);
});


По умолчанию к элементам пользовательского интерфейса, предоставляемым виджетами Autocomplete и SearchBox, применяется стиль для добавления на карту Google. Вы можете изменить этот стиль для соответствия стилю вашего сайта. Доступны следующие классы CSS. Все перечисленные ниже классы могут применяться к виджетам Autocomplete и SearchBox.

Класс CSS Описание
pac-container Графический элемент со списком подсказок, возвращаемых службой Place Autocomplete. Этот выпадающий список отображается под виджетом Autocomplete или SearchBox.
pac-icon Значок, отображаемый слева от каждого элемента в списке подсказок.
pac-item Элемент в списке подсказок, предоставляемых виджетом Autocomplete или SearchBox.
pac-item:hover Отображение элемента при наведении курсора мыши.
pac-item-selected Отображение элемента при его выборе с помощью клавиатуры. Примечание. Выбранные элементы будут входить в этот класс и в класс pac-item.
pac-item-query Часть элемента pac-item, представляющая собой основную часть подсказки. Для географических местоположений содержит название места (например, «Москва») или название улицы и номер дома (например, Ленинский проспект, 21). Для текстового поиска (например, «пицца в Химках») содержит полный текст запроса. По умолчанию элемент pac-item-query имеет черный цвет. Если в элементе pac-item имеется дополнительный текст, он не входит в состав элемента pac-item-query и наследует стиль от элемента pac-item. По умолчанию он имеет серый цвет. Обычно дополнительный текст представляет собой адрес.
pac-matched Часть возвращаемой подсказки, соответствующая введенным данным. По умолчанию этот совпадающий текст выделяется полужирным шрифтом. Совпадающий текст может находиться в любой части элемента pac-item. Он не обязательно должен быть частью элемента pac-item-query и может частично входить в состав элемента pac-item-query, а частично в остальной текст элемента pac-item.
Понравилась статья? Поделиться с друзьями:
Такси
Добавить комментарий

;-) :| :x :twisted: :smile: :shock: :sad: :roll: :razz: :oops: :o :mrgreen: :lol: :idea: :grin: :evil: :cry: :cool: :arrow: :???: :?: :!: