Gerekli istek parametreleri

Map Management API'ye istek göndermek için üstbilgilerinize ve URL'lerinize aşağıdakileri eklemeniz gerekir:

  • Proje Tanımlayıcısı: X-Goog-User-Project başlığında Google Cloud projenizin proje numarası veya kimliği. Bu değer, faturalandırma ve kota hesaplamaları için kullanılan projeyi belirler.

  • Yetkilendirme başlığı: Authorization başlığında bir OAuth 2.0 jetonu. Daha fazla bilgi için OAuth'u kullanma başlıklı makaleyi inceleyin.

  • Kaynak Adı: İstek URL'sindeki bir Google Cloud proje numarası veya kimliği ve belirli kaynak kimliği (ör. mapConfigId veya styleConfigId).

Örnek: MapConfig oluşturma

Aşağıdaki örnekte, curl kullanarak MapConfig nesnesinin nasıl oluşturulacağı gösterilmektedir. Bu isteği gönderdiğinizde, MapConfig oluşturma işlemi başarıyla tamamlandıysa yanıt olarak yeni oluşturulan nesneyi alırsınız.

curl -X POST \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs -d '{
  "displayName": "My New York Map",
  "description": "A Map for New York City",
  "mapType" : "VECTOR",
  "mapFeatures": {
    "simpleFeatures": ["FLATTEN_BUILDINGS", "ICONIC_ICONS"],
    "poiBoostLevel": 1
  }
}'

İstek başarılı olursa yeni oluşturulan harita yapılandırması nesnesini alırsınız: 

{
  "name": "projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID",
  "displayName": "Testing No Type",
  "description": "Testing",
  "mapId": "YOUR_MAP_CONFIG_ID",
  "mapFeatures": {
    "simpleFeatures": [
      "FLATTEN_BUILDINGS",
      "ICONIC_ICONS"
    ],
    "poiBoostLevel": 1
  },
  "createTime": "2026-02-07T20:04:11.467243390Z",
  "updateTime": "2026-02-07T20:04:11.467243542Z",
  "mapType": "VECTOR"
}

Örnek: MapConfig'i silme

Aşağıdaki örnekte, curl kullanarak MapConfig nesnesinin nasıl silineceği gösterilmektedir. Bu isteği gönderdiğinizde MapConfig bulunup başarıyla silindiyse yanıt olarak boş bir JSON nesnesi {} alırsınız.

curl -X DELETE \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapmanagement.googleapis.com/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs/YOUR_MAP_CONFIG_ID

İstek başarılı olursa boş bir yanıt nesnesi alırsınız: 

{}

Proje numarasını alma

Google Cloud projenizin numarasını veya kimliğini almak için:

  1. Cloud Console'da projenin Genel Bakış sayfasına gidin.
  2. Proje numarası ve proje kimliği, Proje bilgileri alanında görünür.

OAuth jetonu alma

Geliştirme veya test için gcloud KSA'yı kullanarak geçici bir OAuth jetonu oluşturabilirsiniz:

gcloud auth application-default print-access-token

gcloud komutunu, daha önceki örneklerde gösterildiği gibi doğrudan bir curl isteğinin Authorization başlığına ekleyebilirsiniz. Alternatif olarak bir ortam değişkeni ayarlayabilirsiniz:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X GET \
-H 'X-Goog-User-Project: YOUR_PROJECT_NUMBER' \
-H "Authorization: Bearer $TOKEN" \
https://mapmanagement.googleapis.com/v2/projects/YOUR_PROJECT_NUMBER/mapConfigs