Все готово!

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

Активация Google Places API Web Service

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

  1. Создание или выбор проекта
  2. Активация Google Places API Web Service
  3. Создание соответствующих ключей

Фотографии мест

Служба фотографий мест в составе Google Places API Web Service – это доступный только для чтения источник высококачественных снимков для вашего приложения. Она открывает доступ к миллионам фотографий, которые хранятся в базах данных Google Places и Google+ Адресов. Идентификаторы фотографий возвращаются автоматически при запросе данных о конкретном месте. При поиске мест поблизости и текстовом поиске для каждого места также возвращается один идентификатор фотографии (при его наличии). Затем вы можете показать фотографию с данным идентификатором пользователю в оптимальном для вашего приложения размере.

Идентификаторы фотографий

Все запросы к службе фотографий мест должны содержать значение параметра photoreference, возвращенное в ответ на поиск места поблизости, текстовый поиск или запрос данных о месте. Если с местом связаны какие-либо фотографии, ответ будет содержать поле photos[].

Примечание. Количество возвращаемых фотографий зависит от типа запроса.

  • В ответах на поиск мест поблизости или текстовый поиск возвращается не более одного элемента photo.
  • Ответы на массовый поиск не содержат фотографий.
  • В ответах на запрос данных возвращается до десяти элементов photo.

Каждый элемент photo содержит следующие поля.

  • photo_reference – строка с идентификатором фотографии, которая возвращается в ответ на запрос изображения.
  • height – максимальная высота изображения.
  • width – максимальная ширина изображения.
  • html_attributions[] – информация об авторстве. Несмотря на то, что это поле может быть пустым, оно всегда включается в ответ.

Служба фотографий передает изображения из множества источников, в том числе фотографии, предоставленные владельцами компаний и пользователями Google+. В большинстве случаев такие фотографии можно использовать без упоминания авторства, либо оно будет указано непосредственно на снимке. Однако, если в возвращенном элементе photo поле html_attributions содержит значение, его необходимо отображать в приложении всегда, когда вы показываете изображение.

Ниже приведен пример массива photos[]:

...
"photos" : [
   {
      "html_attributions" : [],
      "height" : 853,
      "width" : 1280,
      "photo_reference" : "CnRvAAAAwMpdHeWlXl-lH0vp7lez4znKPIWSWvgvZFISdKx45AwJVP1Qp37YOrH7sqHMJ8C-vBDC546decipPHchJhHZL94RcTUfPa1jWzo-rSHaTlbNtjh-N68RkcToUCuY9v2HNpo5mziqkir37WU8FJEqVBIQ4k938TI3e7bf8xq-uwDZcxoUbO_ZJzPxremiQurAYzCTwRhE_V0"
   }
...

Запросы фотографий мест

Запрос фотографии места – это URL-адрес в формате HTTP, который выглядит следующим образом:

https://maps.googleapis.com/maps/api/place/photo?parameters

Чтобы инициировать поисковый запрос, необходимо указать определенные параметры. Все параметры разделяются амперсандами (&) в соответствии со стандартом URL. Ниже приведен список параметров и их возможные значения.

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

  • key – ключ API вашего приложения. Этот ключ используется для идентификации приложения в целях управления квотами. Дополнительную информацию см. в документе Получение ключа.
  • photoreference – уникальный строковый идентификатор фотографии. Указатель фотографии возвращается в ответе на поиск мест или запрос данных о месте.
  • maxheight или maxwidth – указывают значения в пикселях для максимальной высоты и ширины изображения, возвращаемого службой фотографий мест. Если размер изображения меньше указанного, загружается исходная фотография. Если же фотография больше, она уменьшается до соответствия меньшему из значений с сохранением исходных пропорций. Оба свойства – maxheight и maxwidth – могут иметь целочисленные значения в диапазоне от 1 до 1600.

Ниже приведен пример запроса. изображения с ограничением по ширине до 400 пикселей:

https://maps.googleapis.com/maps/api/place/photo?maxwidth=400&photoreference=CnRtAAAATLZNl354RwP_9UKbQ_5Psy40texXePv4oAlgP4qNEkdIrkyse7rPXYGd9D_Uj1rVsQdWT4oRz4QrYAJNpFX7rzqqMlZw2h2E2y5IKMUZ7ouD_SlcHxYq1yL4KbKUv3qtWgTK0A6QbGh87GB3sscrHRIQiG2RrmU_jF4tENr9wGS_YxoUSSDrYjWmrNfeEHSGSc3FyhNLlBU&key=YOUR_API_KEY

Примечание. Чтобы этот запрос был обработан в вашем приложении, используйте в нем свой ключ API.

Ответы на запросы фотографий мест

Ответом на успешный запрос фотографии места будет изображение в том формате, в котором его загрузил автор.

Если вы превысите квоту, сервер вернет состояние HTTP 403 и выведет следующее изображение:

Предупреждение о превышении квоты

Если запрос не будет распознан, сервер вернет состояние HTTP 400, указывающее на недопустимый запрос. Наиболее частые причины, по которым сервер не может распознать запрос:

  • неправильно указан идентификатор фотографии;
  • в запросе не указано значение параметра maxwidth или maxheight.

Сообщения об ошибках

Если служба адресов возвращает состояние HTTP 400, в ответ может быть включено дополнительное поле error_message. Это поле содержит дополнительную информацию о причине выдачи данного кода состояния.

Параметр sensor

Ранее запросы Google Places API Web Service обязательно должны были содержать параметр sensor, чтобы указать, использовался ли приложением датчик для определения местоположения пользователя. Этот параметр больше не используется.

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

Текущей странице
location_on
Google Places API Web Service