В настоящее время Maps Datasets API находится в предварительной версии (pre-GA). Продукты и функции до GA могут иметь ограниченную поддержку, а изменения в продуктах и функциях до GA могут быть несовместимы с другими версиями до GA. Предложения Pre-GA подпадают под действие Особых условий использования платформы Google Карт . Дополнительные сведения см. в описаниях стадий запуска .

Эта страница переведена с помощью Cloud Translation API.

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

Чтобы отправить запрос к API наборов данных Карт, необходимо указать:

Номер или идентификатор вашего проекта Google Cloud в заголовке запроса X-Goog-User-Project . Это значение определяет проект, используемый для выставления счетов и расчета квот использования.
Примечание. Если вы используете учетную запись службы для аутентификации, вы можете опустить заголовок X-Goog-User-Project . Дополнительную информацию об учетных записях служб см. в разделе Аутентификация в Google .
Токен OAuth в заголовке Authorization запроса. Дополнительную информацию об использовании OAuth с API наборов данных Карт см. в разделе Использование OAuth .
Номер или идентификатор проекта Google Cloud в URL-адресе запроса. Это значение указывает проект, содержащий набор данных. Хотя этот проект обычно совпадает с проектом, указанным в заголовке X-Goog-User-Project , он не обязательно должен быть таким же.
Идентификатор набора данных в URL-адресе запроса. Всякий раз, когда вы выполняете действие с определенным набором данных, вы передаете идентификатор набора данных как часть URL-адреса запроса.

Например, чтобы удалить набор данных:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

Получить номер проекта

Чтобы получить PROJECT_NUMBER_OR_ID вашего проекта Google Cloud:

Перейдите на страницу обзора проекта в Cloud Console.
При появлении запроса выберите свой проект.
Номер проекта и идентификатор проекта отображаются в области информации о проекте на обзорном экране.

Получите токен OAuth

Для аутентификации ваш запрос API должен содержать токен OAuth в заголовке Authorization . Дополнительные сведения см. в разделе Использование OAuth .

Например, используйте следующую команду gcloud для создания токена:

gcloud auth application-default print-access-token

Вы можете включить команду gcloud непосредственно в заголовок Authorization команды cURL, чтобы генерировать новый токен при каждом запросе, как показано в примере выше.

Альтернативно вы можете установить переменную среды, содержащую токен, а затем передать переменную среды как часть запроса:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID