Gerekli istek parametreleri

Map Management API'ye istekte bulunmak için başlıklarınıza ve URL'lerinize aşağıdakileri eklemeniz gerekir:

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

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

  • Kaynak adı: İstek URL'sindeki Google Cloud proje numarası veya kimliği ile birlikte 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/v2beta/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 silme

Aşağıdaki örnekte, curl kullanılarak bir MapConfig nesnesinin nasıl silineceği gösterilmektedir. Bu isteği gönderdiğinizde, MapConfig bulunup başarıyla silindiyse yanıtta 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/v2beta/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österilir.

OAuth jetonu alma

Geliştirme veya test için geçici bir OAuth jetonu oluşturmak üzere gcloud KSA'yı kullanabilirsiniz:

gcloud auth application-default print-access-token

gcloud komutunu, daha önceki örneklerde gösterildiği gibi doğrudan bir curl isteğinin Authorization üstbilgisine ekleyebilirsiniz. Alternatif olarak bir ortam değişkeni ayarlayın:

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/v2beta/projects/YOUR_PROJECT_NUMBER/mapConfigs