Прежде чем вы сможете приступить к написанию своего первого клиентского приложения, вам необходимо сделать несколько вещей, если вы еще этого не сделали.
Получить аккаунт Google
Вам понадобится учетная запись Google , чтобы создать проект в консоли Google API. Если у вас уже есть учетная запись, то все готово.
Вам также может потребоваться отдельная учетная запись Google для целей тестирования.
Попробуйте Google Просмотр улиц
В этой документации API предполагается, что вы использовали Google Street View и знакомы с концепциями веб-программирования и форматами веб-данных.
Если вы еще не использовали Google Street View, опробуйте пользовательский интерфейс , прежде чем начинать программировать.
Создайте проект для своего клиента
Прежде чем вы сможете отправлять запросы в Google Street View, вам необходимо сообщить Google о своем клиенте и активировать доступ к API. Это можно сделать с помощью консоли Google API, чтобы создать проект , который представляет собой именованную коллекцию настроек и информации о доступе к API, и зарегистрировать свое приложение.
Чтобы начать использовать API публикации Google Street View, вам необходимо сначала использовать инструмент настройки , который поможет вам создать проект в консоли Google API, включить API и создать учетные данные.
Если вы еще этого не сделали, создайте ключ API своего приложения, нажав Создать учетные данные > Ключ API . Затем найдите свой ключ API в разделе «Ключи API» .
Изучите основы REST
Есть два способа вызвать API:
- Отправка HTTP-запросов и анализ ответов.
- Использование клиентских библиотек .
Если вы решите не использовать клиентские библиотеки, вам необходимо понять основы REST.
REST — это стиль архитектуры программного обеспечения, обеспечивающий удобный и последовательный подход к запросу и изменению данных.
Термин REST является сокращением от « Передача представительского состояния ». В контексте API Google это относится к использованию команд HTTP для получения и изменения представлений данных, хранящихся в Google.
В системе RESTful ресурсы хранятся в хранилище данных; клиент отправляет запрос на то, чтобы сервер выполнил определенное действие (например, создание, получение, обновление или удаление ресурса), а сервер выполняет действие и отправляет ответ, часто в форме представления указанного ресурса.
В API-интерфейсах RESTful Google клиент указывает действие с помощью команды HTTP, такой как POST , GET , PUT или DELETE . Он определяет ресурс с помощью глобально уникального URI следующей формы:
https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters
Поскольку все ресурсы API имеют уникальные URI, доступные по HTTP, REST обеспечивает кэширование данных и оптимизирован для работы с распределенной инфраструктурой Интернета.
Определения методов в документации по стандартам HTTP 1.1 могут оказаться полезными; они включают спецификации для GET , POST , PUT и DELETE .
REST в API публикации Google Street View
Операции API публикации Google Street View напрямую сопоставляются с HTTP-глаголами REST.
Конкретные форматы URI API публикации Google Street View:
https://www.googleapis.com/streetviewpublish/v1/resourcePath?parameters
Полный набор URI, используемых для каждой поддерживаемой операции в API, приведен в справочном документе Google Street View Publish API .
Изучите основы JSON
API публикации Google Street View возвращает данные в формате JSON.
JSON (нотация объектов JavaScript) — это распространенный, независимый от языка формат данных, который обеспечивает простое текстовое представление произвольных структур данных. Для получения дополнительной информации посетите json.org .