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