Google Haritalar Platformu Raporlaması

Google Haritalar Platformu'ndaki raporlama, Google Cloud Console'da temel API kullanımı, kota ve faturalandırma bilgilerini içeren önceden tanımlanmış bir dizi görsel rapor sağlar. Yaptığınız API çağrılarının sayısını, API kullanım kotalarına ne kadar yaklaştığınızı belirlemek ve zaman içindeki faturalandırma kullanımınızı izlemek için bu raporları kullanın.

Rapor türleri şunlardır:

• Kullanım raporları: Projenizin, projenizle ilişkili kimlik bilgilerini kullanarak Google Haritalar Platformu API'lerine gönderdiği istek sayısını raporlar.
• Kota raporları: Kota kullanımını, dakika başına istek sayısına göre gruplandırılabilen grafiklerde raporlar. Seçilen API'ler için geçerli kota sınırları, kota kullanımı grafiklerinin altındaki tablolarda gösterilir.
• Faturalandırma raporları: Zaman içindeki maliyetleri yığılmış çizgi grafik olarak raporlar. Uygulanan kullanıma özel krediler dahil olmak üzere mevcut ayın kota kullanımını ve mevcut ayın tamamı için tahmini toplam maliyeti görüntüleyin.
• Etkileşim raporları: Kullanıcıların harita uygulamalarınızla nasıl etkileşimde bulunduğuyla ilgili işletme analizleri sağlar.

Bir isteğin Kullanım, Kota ve/veya Faturalandırma raporlarında görünüp görünmeyeceğini tanımlayan yanıt durumlarının ve yanıt kodlarının tam listesi için Yanıt durumu ve raporlar başlıklı makaleyi inceleyin.

Cloud Console'u kullanarak Google Haritalar Platformu kullanımı, kota ve faturalandırma raporlarını görüntüleyin.

Kullanım raporları

Kullanım, projenizle ilişkili kimlik bilgilerini kullanarak projenizin Google Haritalar Platformu API'lerine gönderdiği isteklerin sayısına bağlıdır. İstekler; başarılı istekler, sunucu hatalarına neden olan istekler ve istemci hatalarına neden olan istekleri içerir. Kimlik bilgileri arasında API anahtarları ve istemci kimlikleri (Premium Plan ve taşınan Premium Plan projeleri için) bulunur. Ayrıntılar için Premium Plan'a Genel Bakış'a ve istemci kimliği kullanımıyla ilgili bilgilere bakın.

Kullanım metrikleri tablolarda (İstekler, Hatalar ve Gecikme) ve grafiklerde (Trafik, Hatalar ve Gecikme) gösterilir. İzleme amacıyla:

• Tüm API'ler: Tüm API'lerin kullanım metriklerini aşağıdaki yöntemlerle filtreleyebilir ve gruplandırabilirsiniz:

  • Döneme ve API'ye göre filtreleyin.
  • Yanıt koduna, API'ye ve kimlik bilgisine göre gruplandırılmış trafik, hata ve gecikmeyi görün.

• Belirli bir API: Belirli bir API'nin kullanım metriklerini aşağıdaki yöntemlerle filtreleyebilir ve gruplandırabilirsiniz:

  • Dönem, API sürümü, kimlik bilgileri ve yöntemlere göre filtreleme yapın.
  • Yanıt koduna, API yöntemine ve sürümüne, kimlik bilgisine göre gruplandırılmış trafiği, hatayı ve gecikmeyi görün.

API'ler ve Hizmetler Kontrol Paneli sayfası

API'ler ve Hizmetler Kontrol Paneli, projenizde etkinleştirilen tüm API'lerin (Google Haritalar Platformu API'lerinin yanı sıra diğer API'ler ve hizmetler) kullanım metriklerine genel bir bakış sunar.

• Kontrol paneli sayfasında üç grafik ve bir tablo bulunur. Grafiklerde ve tablolarda gösterilen kullanımı, 1 saatten son 30 güne kadar bir dönem seçerek filtreleyebilirsiniz.

• Trafik grafiği, API başına dakika başına sorgu (QPM) olarak kullanımı gösterir.

• Hatalar grafiği, API başına hatayla sonuçlanan isteklerin yüzdesini gösterir.

• Gecikme grafiği, API başına isteklerin ortalama gecikmesini gösterir.

Grafiklerin altında, etkin API'ler ve hizmetler tabloda listelenir. İstekler, isteklerin sayısıdır (seçilen dönem için). Hatalar, bu isteklerin hatayla sonuçlanan sayısıdır. Gecikme (orta gecikme ve yüzdelik dilim), bu isteklerin gecikmesidir.

API'ler ve Hizmetler Kontrol Paneli sayfasına erişmek için:

1. Cloud Console'da Proje seçici sayfasını açın:

   Proje seçici sayfası

2. Projenizi seçin. API'ler ve Hizmetler Kontrol Paneli sayfası görüntülenir.
   
   Sayfa görünmüyorsa menü düğmesini seçin ve ardından API'ler ve Hizmetler'i seçin.

Daha fazla bilgi için API Kullanımınızı İzleme başlıklı makaleyi inceleyin.

Google Haritalar'a Genel Bakış sayfası

Google Haritalar Genel Bakış sayfasında, etkin API'leri ve son 30 güne ait kullanım isteklerini listeleyen bir tablo bulunur. API'ye göre istekler de grafik şeklinde gösterilir. Faturalandırma grafiğinde mevcut faturanız ve son 3 aya ait toplam kullanımınız gösterilir.

Not: Etkin bir API'nin adını seçerseniz ilgili API'nin Google Haritalar Metrikler sayfasına yönlendirilirsiniz.

Google Haritalar Platformu'na Genel Bakış sayfasına erişmek için:

1. Cloud Console'da Google Haritalar Platformu sayfasını açın:

   Google Haritalar Platformu sayfasına gidin

2. Soldaki menüde Genel bakış'ı seçin.

Google Haritalar Platformu API'leri ve Hizmetleri sayfası

Google Haritalar API'ler ve Hizmetler sayfasında, projenizde kullanabileceğiniz API'leri, SDK'ları ve diğer hizmetleri gösteren bir karo ızgarası bulunur. Her kartta Etkinleştir veya Devre dışı bırak'ı seçerek ilgili hizmeti etkinleştirebilir ya da devre dışı bırakabilir, ayrıca etkin API'ler için kimlik bilgileri, metrikler ve kullanıcı kılavuzlarına erişebilirsiniz. Etkin veya devre dışı bırakılmış hizmetleri ve diğer hizmet kategorilerini görüntülemek için sayfa filtrelerini de kullanabilirsiniz.

Google Haritalar Platformu API'ler ve Hizmetler sayfasına erişmek için:

1. Cloud Console'da Google Haritalar Platformu sayfasını açın:

   Google Haritalar Platformu sayfasına gidin

2. Sol menüden API'ler ve Hizmetler'i seçin.

Google Haritalar Metrikleri sayfası

Google Haritalar Metrikler sayfasında üç grafik gösterilir: Trafik, Hatalar ve Ortalama Gecikme. Grafiklerdeki kullanım verileri yanıt kodu sınıfına, API'ye, API yöntemine, kimlik bilgisine, platforma ve alana göre gruplandırılabilir.

Metrikler sayfasındaki grafiklerin altında, seçtiğiniz API'lerin isteklerini, hatalarını ve gecikmesini gösteren bir API tablosu bulunur.

Üstteki API açılır menüsünü ve sağ bölmede bulunan gruplandırma ve filtreleme seçeneklerini kullanarak belirli veya birden fazla API, Kimlik Bilgileri, Yanıt Kodu sınıfları, Platform türü ve/veya Alan seçerek görüntülenen kullanım metriklerini gruplandırabilir ve filtreleyebilirsiniz. Gösterilen kullanım metrikleri için bir dönem (bir saatten son 30 güne kadar) ve ayrıntı düzeyi (saniye veya gün başına) de seçebilirsiniz.

Not: Gruplandırılma ölçütü açılır listesinde Platform ve Alan seçeneği ve Platform ile Alan filtreleri yalnızca API seçim açılır listesinden tek bir API seçtiğinizde görünür.

Aşağıdaki resimlerde, Gruplandırılma ölçütü açılır listesinde Platform ve Alan'a göre gruplandırma seçildiğinde tek bir API için Platform ve Alan filtreleri gösterilmektedir:

Google Haritalar Platformu API Metrikleri sayfasına erişmek için:

1. Cloud Console'da Google Haritalar Platformu sayfasını açın:

   Google Haritalar Platformu sayfasına gidin

2. Sol menüden Metrikler'i seçin.

Kimlik bilgisi raporlaması

Metrikleri, API'yi yüklemek için kullanılan kimlik bilgisine göre filtreleyebilir ve gruplandırabilirsiniz.

Kimlik bilgisi biçimi	Anlamı
Anahtar adı Örneğin, "Mobil uygulama anahtarı"	?key=... kullanılarak API'yi yüklemek için bir API anahtarı kullanıldı: Anahtar adlarını Haritalar Platformu Console'daki Anahtarlar ve Kimlik Bilgileri bölümünde bulabilirsiniz.
Proje Numarası Örneğin, 123456 proje numaranız olduğunda "project_number:123456".	Bu kimlik bilgisini gördüğünüzde iki olasılık vardır: Maps Platform istemci kimliklerini kabul eden API'ler için: API'yi yüklemek amacıyla bir Maps Platform istemci kimliği kullanıldı. Örneğin, &client=gme-_mycompany_ kullanarak. Şu API'ler istemci kimliklerini kabul eder: Maps JavaScript API, Maps Static API, Street View Static API, Elevation API, Directions API, Distance Matrix API, Geocoding API, Time Zone API. Daha fazla bilgi için Premium Plan istemci kimliği yönetimi başlıklı makaleyi inceleyin. OAuth'u kabul eden API'ler için: API, API anahtarı olmadan OAuth kullanılarak yüklendi.

Not: Hem Maps Platform istemci kimliklerini hem de OAuth'u destekleyen Maps Platform API'si yoktur. Bu nedenle, API'nin bir istemci kimliğiyle mi yoksa OAuth ile mi yüklendiğini, kullanılan API'ye göre anlayabilirsiniz.

Yanıt kodu grafikleri

Yanıt koduna göre trafik ve Yanıt koduna göre hata grafikleri, kullanımı HTTP yanıt kodu sınıfına göre böler. Bu tabloda, Google Haritalar Platformu API yanıt durumu ile HTTP yanıt kodu sınıfı arasındaki eşleme gösterilmektedir:

Maps API durumu	HTTP yanıt kodu sınıfı - Kullanım raporu (2xx, 3xx, 4xx, 5xx)	Notlar
Tamam	2xx	Başarılı yanıt. Bu faturalandırılabilir bir istektir ve kotayı tüketir.
Tamam	3xx	Başarılı yanıt. Bu faturalandırılabilir bir istektir ve kotayı tüketir. Örneğin, Yer Fotoğrafı başarılı istekleri, başvurulan resme 302 yönlendirmesi döndürür.
DATA_NOT_AVAILABLE	4xx^(1)	Giriş konumları için kullanılabilen veri olmadığını belirten başarılı yanıt. Bu, faturalandırılabilir bir istektir ve kotayı tüketir.
ZERO_RESULTS	4xx^(1)	Başarılı yanıt hiçbir sonuç döndürmedi. Bu faturalandırılabilir bir istektir ve kotayı tüketir.
NOT_FOUND	4xx^(1)	Directions API için bu mesaj, istekteki başlangıç, varış veya yol üstü noktalarında belirtilen konumlardan en az birinin coğrafi kodlanamadığı anlamına gelir. Places API için bu mesaj, referans verilen konumun (place_id) Places veritabanında bulunamadığını gösterir. Bu, faturalandırılabilir bir istektir ve kotayı tüketir.
INVALID_REQUEST (geçersiz parametre değeri), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED ve diğerleri.	4xx	Geçersiz parametre değerinden kaynaklanan hata. Daha fazla bilgi için API yanıtını kontrol edin. Bu, faturalandırılabilir bir istektir ve kotayı tüketir.
REQUEST_DENIED	4xx	Kimlik doğrulama hatası, erişim hatası ve diğer nedenlerden kaynaklanan istemci hatası. Daha fazla bilgi için API yanıtını kontrol edin.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded	4xx	İzin verilen zaman aralığı başına çok fazla istek gönderilmesinden kaynaklanan istemci hatası. İsteği daha sonra tekrar deneyin. Daha fazla bilgi için API yanıtını kontrol edin.
INVALID_REQUEST (geçersiz veya eksik parametre, istek ayrıştırma veya doğrulama hatası)	4xx	Geçersiz istek nedeniyle istemci hatası. Daha fazla bilgi için API yanıtını kontrol edin.
NOT_FOUND (404)	4xx	Coğrafi Konum API için bu mesaj, girişlerin konum tahmini oluşturmak için yeterli olmadığını gösterir. Roads API için bu mesaj, girişlerin yollara makul bir şekilde bağlanamadığını gösterir. Bu, faturalandırılabilir bir istektir ve kotayı tüketir.
UNKNOWN_ERROR	5xx	İsteğin devam edemediğini belirten sunucu hatası: dahili hata, hizmet aşırı yüklü, kullanılamıyor, zaman aşımı ve diğerleri.
^1 Hata kodu raporlamasının tutarlılığını iyileştirmek için Google Maps Platform API'leri taşınıyor: 1) DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - durum için HTTP yanıt kodu sınıfı 2xx'den 4xx'e, 2) REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded için HTTP yanıt kodu sınıfı 2xx'den 4xx'e, 3) UNKNOWN_ERROR için HTTP yanıt kodu sınıfı 2xx'den 5xx'ye. Geçiş döneminde her iki yanıt kodunu da görebilirsiniz. Haritalar API yanıtlarında döndürülen yanıt kodları değişmeyecek. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx değerinin artmasının bu taşımayla ilgili olduğunu onaylayın (Google Haritalar Platformu için Google Cloud İzleme'yi kullanma hakkında daha fazla bilgi edinin).

Durum kodları ve hata mesajları hakkında daha fazla bilgi için ilgilendiğiniz API'nin yanıt dokümanlarına (ör. Coğrafi Kodlama Yanıtları veya Yol Tarifi Yanıtları) bakın.

Google Haritalar Platformu çözümleri parametresi

Google Haritalar Platformu, hızlı bir şekilde çalışmaya başlamanıza yardımcı olacak birçok örnek kod türü sağlar. Örneğin, Cloud Console'da Hızlı Oluşturucu'yu kullanabilir, sektör çözümlerinin uygulama kılavuzlarını takip edebilir ve kod laboratuvarlarından yararlanabilirsiniz.

Google, kullanımları ve çözümlerimizi iyileştirmenin yollarını anlamak için örnek kod kullanımı hakkında bilgi toplamak amacıyla API çağrılarına solution_channel sorgu parametresini ekler:

• solution_channel sorgu parametresi, çözüm örnek koduna varsayılan olarak dahil edilir.
• Sorgu parametresi, gelecekteki iterasyonlarda çözüm kalitesini iyileştirmek için Google'a çözüm benimsemeyle ilgili analizler döndürür.
• solution_channel sorgu parametresini ve değerini örnek koddan silerek devre dışı bırakabilirsiniz.
• Parametreyi tutma zorunluluğu yoktur. Sorgu parametresinin kaldırılması performansı etkilemez.
• Sorgu parametresi yalnızca örnek kod kullanımı raporlaması için kullanılır.
• Sorgu parametresi, API'ye özgü analizlerden ve raporlardan ayrıdır. Yani parametrenin çözüm örnek kodundan kaldırılması, dahili Maps JavaScript API raporlamasını devre dışı bırakmaz.

Kota raporları

Kotalar, projenizin Google Haritalar Platformu API'lerine gönderebileceği istek sayısına sınırlar getirir. İstekler üç şekilde sınırlanabilir: gün başına, dakika başına ve kullanıcı başına dakika başına. Yalnızca başarılı istekler ve sunucu hatalarına neden olan istekler kotaya dahil edilir. Kimlik doğrulama işleminin başarısız olduğu istekler kotaya dahil edilmez.

Kota kullanımı, Cloud Console'daki Kotalar sayfasında grafiklerle gösterilir ve dakika başına istek sayısına göre gruplandırılabilir. Seçilen API'ler için geçerli kota sınırları, kota kullanımı grafiklerinin altındaki tablolarda gösterilir.

Herhangi bir GMP API ürünü için dakika başına kota değerinizi öğrenmek üzere bu hesaplayıcıyı kullanın.

Google Haritalar kotaları sayfası

Google Haritalar Kotalar sayfasında, seçtiğiniz API'nin kota sınırları ve kota tüketimi gösterilir.

Google Cloud Console'daki kota kullanımı grafiği, API anahtarlarınız ve istemci kimliklerinizin toplam trafiğini gösterir. İstemci kimliği trafiği, Cloud Console'daki Metrikler grafiğinde de gösterilir.

Sayfada yalnızca kota tüketen istekler gösterilir: başarılı istekler (OK, ZERO_RESULTS, DATA_NOT_AVAILABLE) ve sunucu hatalarına neden olan istekler (NOT_FOUND, INVALID_REQUEST/INVALID_VALUE (geçersiz parametre değeri), UNKNOWN_ERROR).

Müşteri hatalarına neden olan istekler (kimlik doğrulama, yetkilendirme ve geçersiz bağımsız değişken hataları (REQUEST_DENIED, OVER_QUERY_LIMIT, INVALID_REQUEST (geçersiz parametre, istek ayrıştırma hatası))) kotayı tüketmez ve gösterilmez.

Kota birimi, Google Haritalar Platformu API'lerinin çoğu (Maps Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API ve Elevation API) için bir istektir ancak bazı istisnalar vardır:

• Mesafe Matrisi API'sinde kota birimi, başlangıç-hedef çifti olan bir öğedir.
• Maps JavaScript API için kota birimi, harita yüklemesidir.
• Android için Haritalar SDK'sı ve iOS için Haritalar SDK'sında kota birimi, Street View isteği veya Panorama yüklemesidir. Harita yüklemeleri ücretsizdir ve kotayı tüketmez.

Google Haritalar Platformu kotaları sayfasına erişmek için:

1. Cloud Console'da Google Haritalar Platformu sayfasını açın:

   Google Haritalar Platformu sayfasına gidin

2. Sol menüden Kotalar'ı seçin.
3. API açılır listesinden bir API seçin.

Kota birimleri

Bu tabloda, Google Haritalar Platformu API'leri için kota birimi gösterilmektedir.

Google Haritalar Platformu API'si	Kota birimi
Haritalar
Android için Haritalar SDK'sı	1 panorama
iOS için Haritalar SDK'sı	1 panorama
Map Tiles API	1 istek
Haritalar Kuş Bakışı API'si	1 istek
Maps Static API	1 istek
Maps JavaScript API	1 Harita Yükleme
Street View Static API	1 istek
Maps Embed API	1 Harita Yükleme
Rotalar
Routes API (Compute Routes)	1 istek
Routes API (Compute Route Matrix)	1 Öğe (başlangıç-hedef çifti)
Directions API	1 istek
Distance Matrix API	1 Öğe (başlangıç-hedef çifti)
Roads API	1 istek
Route Optimization API	1 istek
Android için Navigasyon SDK'sı	1 hedef
iOS için Navigasyon SDK'sı	1 hedef
Yerler
Places API	1 istek
Address Validation API	1 istek
Geocoding API	1 istek
Geolocation API	1 istek
Time Zone API	1 istek
Ortam
Air Quality API (CurrentConditions ve HeatmapTile)	1 istek
Air Quality API (Geçmiş)	1 sayfa
Pollen API	1 istek
Solar API	1 istek

Fatura raporları

Faturalandırma raporunuzu görüntüleme

Google Haritalar Platformu ürünlerini kullanımınıza ilişkin faturalandırma raporları Google Cloud Console'da mevcuttur. Daha fazla bilgi için Faturalandırma başlıklı makaleyi inceleyin.

Faturalandırma raporlarına erişmek için:

1. Cloud Console'da Proje seçici sayfasını açın:

   Proje seçici sayfası

2. Proje seçin.
3. Menü düğmesini seçin ve ardından Faturalandırma'yı seçin.
4. Birden fazla faturalandırma hesabınız varsa bağlı faturalandırma hesabının Genel bakış sayfasını açmak için Bağlı faturalandırma hesabına git'i seçin.
5. Bağlı faturalandırma hesabının faturalandırma Raporları sayfasını açmak için sol menüden Raporlar'ı seçin.

Faturalandırma raporu grafiğini okuma

Faturalandırma raporları, maliyeti zaman içinde yığılmış çizgi grafik olarak gösterir. Varsayılan görünümde, geçerli ayın günlük kullanıma özel maliyetleri (tüm ürünler için) uygulanan kullanıma özel krediler dahil olmak üzere projeye göre gruplandırılmış olarak gösterilir. Ayrıca geçerli ayın tamamı için tahmini toplam maliyet de gösterilir. Grafikteki her satır (ve özet tablosundaki her satır), maliyete göre en büyükten en küçüğe doğru sıralanan projeye karşılık gelir. Faturalandırma raporu grafiğini yorumlama hakkında daha fazla bilgi edinin.

Şekil 1: Varsayılan önceden ayarlanmış görünümü kullanarak grafik ve tabloyu gösteren faturalandırma raporu.

İpucu: SKU başına kullanım ve maliyeti analiz edin

Kullandıkça öde fiyatlandırma modelinin ayrıntılarını ve uygulamanızı nasıl etkilediğini daha doğru anlamak için SKU'ya göre kullanım ve maliyetinize bakın.

Şekil 2: SKU'ya göre kullanım ve maliyet satır öğelerini gösteren faturalandırma tablosu.

Şekil 3: Faturalandırma raporu filtreleri.

Satır öğelerini SKU'ya göre görüntülemek için rapor görünümünü değiştirmek üzere:

1. Grafiğin sağındaki panelde Gruplandır filtresini genişletin.
2. SKU'yu seçin.

Kullanabileceğiniz diğer faturalandırma raporu filtreleri arasında Zaman aralığı, Projeler, Ürünler, SKU'lar ve API isteklerinin sunulduğu yere göre filtreleme yapmanıza olanak tanıyan Konumlar yer alır.

Ürüne ek olarak kullanım kaynağınızı kategorize etmek için faturalandırma raporlarını listelenen değerlerden birine göre gruplandırın. Google Haritalar Platformu API'leriyle ilgili üç anahtar şunlardır: goog-maps-api-key-suffix (API anahtarının son dört karakteri), goog-maps-platform-type (platform: Android, iOS, JavaScript veya web hizmeti) ve goog-maps-channel (API sorgusundan alınan bir sayısal kanal değeri). Filtreleme ve gruplandırma hakkında daha fazla bilgi

Sağ paneldeki Kredileri maliyete dahil et onay kutusunu temizleyerek grafik görünümünü, kullanıma özel kredileri hariç tutacak şekilde değiştirebilirsiniz.

Tüketimi izleme ve kısıtlama

Bütçenizi planlamanıza ve maliyetleri kontrol etmenize yardımcı olması için aşağıdakileri yapabilirsiniz:

• Harcamalarınızın belirli bir tutara doğru nasıl arttığını izlemek için bütçe uyarısı ayarlayın. Bütçe ayarlamak API kullanımına sınır getirmez. Yalnızca harcama tutarınız belirtilen tutara yaklaştığında sizi uyarır.

• Faturalandırılabilir API'lerin kullanım maliyetinizi yönetmek için günlük API kullanım sınırınızı belirleyin. Günlük istek sayısı için sınırlar belirleyerek harcamanızı sınırlandırabilirsiniz. Harcamak istediğiniz tutara bağlı olarak günlük sınırınızı belirlemek için basit bir denklem kullanın. Örneğin: (Aylık harcama /her SKU başına fiyat)/30 = günlük istek sınırı (bir API için).

  Not: Uygulamanızda birden fazla faturalandırılabilir API kullanılıyor olabilir. Bu nedenle, denklemi gerektiği gibi ayarlayın. Her ay 200 ABD doları değerinde Google Haritalar Platformu kredisi kullanılabileceğini unutmayın. Bu nedenle, hesaplamanıza bu krediyi dahil ettiğinizden emin olun. Google Haritalar Platformu'nun sunduğu aylık 200 ABD doları değerindeki kredi teklifi 28 Şubat 2025 saat 23:59'a (yerel saat) kadar geçerlidir. 1 Mart 2025'ten itibaren 200 ABD doları kredi, her API için ücretsiz kullanım eşiğiyle değiştirilecek. Daha fazla bilgi için SSS bölümünü inceleyin.

Kanal başına kullanım izleme

Kullanımınızı sayısal kanallar aracılığıyla izlemek için API isteklerinize "channel" parametresini eklemeniz gerekir. Yalnızca 0 ile 999 arasında sayılar kabul edilir. Aşağıda birkaç örnek verilmiştir:

• Geocoding Web Service API

  https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1

• Maps JavaScript API

  <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
  async defer></script>

Kanal kullanımınızı doğrudan Faturalandırma Raporunuzdan izleyin. Kanallar, Etiketler bölümünde goog-maps-channel anahtarı olarak gösterilir.

Not: Kanal verileri Android için Haritalar SDK'sı, iOS için Haritalar SDK'sı, Yerler API'si (Yeni), Adres Doğrulama API'si, Hava Görünüm API'si, Hava Kalitesi API'si, Harita Karoları API'si, Haritalar Veri Kümeleri API'si, Yollar API'si, Rotalar API'si, Polen API'si, Güneş Enerjisi API'si ve Rota Optimizasyonu API'si için kullanılamaz.

Şekil 4: SKU ve kanallara göre filtreleme

Faturalandırma raporunuzu SKU'ya ve kanala göre filtrelemek için:

1. Gruplandırma ölçütü SKU filtresini kullanın.
2. Etiketler oku seçin.
3. Anahtar açılır menüsünü ve goog-maps-channel'ı seçin.
4. Değer açılır menüsünü ve filtrelemek istediğiniz sayısal kanalları seçin.

Her kanalın oluşturduğu maliyeti görmek için etiket anahtarına goog-maps-channel göre gruplandırın.

Kanal kullanım verilerini isteklerinize uyguladıktan sonra verilerin faturalandırma raporunuza yansıtılması 24 saati bulabilir.

Faturalandırma verilerinizi BigQuery ile dışa aktarma

Faturalandırma verilerinizi BigQuery'ye de aktarabilirsiniz.

BigQuery dışa aktarma özelliği, ayrıntılı Cloud Billing verilerini (kullanım ve maliyet tahmini verileri gibi) belirttiğiniz bir BigQuery veri kümesine gün boyunca otomatik olarak aktarmanıza olanak tanır. Ardından, ayrıntılı analiz için BigQuery'den faturalandırma verilerinize erişebilirsiniz. Bu sayede, Google Haritalar Platformu kullanımınızın kaynağını daha ayrıntılı bir şekilde anlayabilirsiniz.

BigQuery Export'u kullanmaya ve verileri sorgulamaya başlamak istiyorsanız aşağıdaki örnek sorguyu deneyebilirsiniz. Bu sorguyu çalıştırmadan önce:

• Hesabınızda faturalandırmayı ve BigQuery faturalandırma dışa aktarma özelliğini etkinleştirin.
• Tablo biçimi PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID şeklindedir. Burada:
• PROJECT_ID, gerçek proje kimliğinizdir (ör. "projem-123456").
• DATASET_NAME, oluşturduğunuz veri kümesinin adıdır (ör. "SampleDataSet").
• BILLING_ACCOUNT_ID, faturalandırma hesabı kimliğinizin referansı olup "gcp_billing_exportv1" ön ekiyle başlar ve kısa çizgiler (-) alt çizgilerle (_) değiştirilir. Örneğin, 123456-7890AB-CDEF01 faturalandırma hesabı kimliği gcp_billing_export_v1_123456_789AB_CDEF01 olur.

Not: Yeni bir veri kümesi oluşturduğunuzda bu veri kümesi arayüzde hemen görünür ancak sorgulanacak tablo henüz görünmez. Tablo birkaç saat sonra otomatik olarak oluşturulur. Ardından, verilerinizin görünmesi yaklaşık 24 saat sürer. BigQuery veri kümeniz yalnızca faturalandırma verilerini dışa aktarma işlemini ayarladığınız tarihten itibaren oluşan kullanım ve maliyet verilerini yansıtır. Başka bir deyişle, faturalandırma verileri geriye dönük olarak eklenmez. Bu nedenle, BigQuery dışa aktarma özelliğini etkinleştirmeden önceki faturalandırma verilerini görmezsiniz.

  #standardSQL
  SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
           invoice.month                                 AS invoice_month,
           service.description                           AS service,
           sku.description                               AS sku,
           (
                  SELECT l.value
                  FROM   Unnest(labels) AS l
                  WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
           Round(Sum(usage.amount), 2)                 AS usage_amount,
           usage.unit                                  AS usage_unit,
           Round(Sum(cost), 2)                         AS cost,
           cost_type,
           currency
  FROM     PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
  WHERE    invoice.month = '202002' -- Change the invoice month with the same format as the example.
  GROUP BY billing_day,
           invoice_month,
           service,
           sku,
           goog_maps_channel,
           usage_unit,
           cost_type,
           currency
  ORDER BY billing_day,
           service,
           sku
  

İlgili kaynaklar

Cloud Billing:

• Cloud Faturalandırma hesabınızı oluşturma, değiştirme veya kapatma
• Bir projenin faturalandırma ayarlarını değiştirme
• Faturalandırma Raporlarınızı ve Maliyet Trendlerinizi Görüntüleme
• Bütçeleri ve bütçe uyarılarını ayarlama
• API Kullanımını Sınırlama

Google Haritalar Platformu:

• Google Haritalar Platformu Faturalandırması
• Optimizasyon Rehberi
• API Anahtarı İçin En İyi Uygulamalar

Yanıt durumu ve raporlar

Aşağıdaki tabloda, Haritalar API durumu, Haritalar API yanıtlarında döndürülen HTTP yanıt kodu ve Kullanım Raporu'ndaki HTTP yanıt kodu sınıfı arasındaki eşleme gösterilmektedir. Ayrıca, ilgili isteğin Kullanım, Kota ve Faturalandırma raporlarında görünüp görünmediği de belirtilmektedir.

Not: Geçmiş nedenlerden dolayı, Google Haritalar Platformu API isteklerine yanıt olarak döndürülen HTTP yanıt kodu, Kullanım raporlarındaki (Google Haritalar Platformu Metrikleri) HTTP yanıt kodundan farklı olabilir. Kullanım raporları metrikleri, yeni API'lerde kullanılanlarla tutarlı bir yanıt kodu değeri grubu kullanır. Bu sayede, Google Haritalar Platformu Metrikleri ve Google Haritalar Platformu İzleme'de API kullanımının gözlemlenebilirliği artar.

Google Haritalar Platformu Metrikleri'ndeki Kullanım Raporu HTTP response code class ayrıntı düzeyindedir. Daha yüksek düzeyde ayrıntıya ihtiyacınız varsa Google Haritalar Platformu Kullanım İzleme'de bulunan Yanıt durum kodları'na bakın.

Maps API yanıtlarında kullanılabilen yanıt kodları		Kullanım raporunda kullanılabilir.	Bildirilen
Maps API durumu	HTTP yanıt kodu	HTTP yanıt kodu sınıfı	Kullanım	Kota	Faturalandırma
Tamam	200, 204, 302	2xx, 3xx	Evet	Evet	Evet
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS	200, 404	4xx^1	Evet	Evet	Evet
INVALID_REQUEST (geçersiz parametre değeri), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, vb.	200, 400	4xx	Evet	Evet	Evet
INVALID_REQUEST (geçersiz/eksik parametre, istek ayrıştırma hatası)	200, 400	4xx	Evet	Hayır	Hayır
REQUEST_DENIED	200, 400, 403	4xx^1	Evet	Hayır	Hayır
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx^1	Evet	Hayır	Hayır
UNKNOWN_ERROR	200, 500, 503	5xx^1	Evet	Evet	Hayır
^1 Hata kodu raporlamasının tutarlılığını iyileştirmek için Google Maps Platform API'leri taşınıyor: 1) DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - durum için HTTP yanıt kodu sınıfı 2xx'den 4xx'e, 2) REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded için HTTP yanıt kodu sınıfı 2xx'den 4xx'e, 3) UNKNOWN_ERROR için HTTP yanıt kodu sınıfı 2xx'den 5xx'ye. Geçiş döneminde her iki yanıt kodunu da görebilirsiniz. Haritalar API yanıtlarında döndürülen yanıt kodları değişmeyecek. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx değerinin artmasının bu taşımayla ilgili olduğunu onaylayın (Google Haritalar Platformu için Google Cloud İzleme'yi kullanma hakkında daha fazla bilgi edinin).

Etkileşim raporları

Bu ürün veya özellik deneyseldir (GKST öncesi). GKST öncesi ürünler ve özelliklere verilen destek sınırlı olabilir. Ayrıca bu ürünler ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmete Özgü Şartlar'a tabidir. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

İşletme Analizleri

Google Haritalar Platformu, kullanıcıların haritalarınızla nasıl etkileşimde bulunduğuna dair analizler sunar. Bu analizler, bir haritadaki görüntüleme sayısı veya ÖY ile etkileşimler gibi önemli etkileşim metriklerini içerir. Reklamcılık ve pazarlama için popüler konumları keşfetmek veya kullanıcı deneyiminizi optimize etmek amacıyla bu analizleri inceleyebilirsiniz.

İşletme bilgileri raporlama özellikleri şunlardır:

• İşletme analizlerindeki önemli trendleri bir bakışta görmek için üst düzey bir işletme analizi anlık görüntüsünü görüntüleme
• Metrikleri daha ayrıntılı bir şekilde anlamak için konsolda belirli bir metriği analiz etmek üzere ayrıntılı inceleme
• Metrikleri CSV'ye aktararak işletme analizleri verilerini favori işletme analiz aracınızda analiz edebilirsiniz.

Kullanılabilen etkileşim metrikleri şunlardır:

• Harita Görüntüleme Sayısı: Haritayı kaydırarak, yakınlaştırarak veya eğdirerek yapılan görüntülemelerin sayısını izler. Harita görüntülemeleri, posta koduna göre haftalık olarak (Pasifik saatine göre Pazar-Cumartesi) hesaplanır. Yeni veriler, gözlem dönemini takip eden ilk Çarşamba günü haftalık olarak yayınlanır.

Proje sahipleri ve Haritalar Analytics Görüntüleyici rolüne sahip kullanıcılar, Cloud Console'daki Metrikler Sayfası'nda işletme analizlerini görüntüleyebilir. Projede Maps JavaScript API etkin olmalıdır.

Metrikleri daha ayrıntılı şekilde incelemek için filtreleme ve gruplandırma özelliklerini kullanarak etkileşim metriklerini doğrudan konsolda analiz edebilirsiniz. Örneğin, harita görüntülemelerinin yalnızca belirli bir bölgedeki posta kodları için nasıl bir trend gösterdiğini öğrenmek üzere belirli bir bölgeye göre filtreleme yapmayı seçebilirsiniz. Öte yandan, belirli bir bölgedeki etkileşimleri toplamak için belirli bir bölgeye göre gruplandırma yapmak isteyebilirsiniz.

Kullanıcılar, en sevdikleri iş analizi aracında daha ayrıntılı analiz yapmak için veri kümesinin tamamını veya filtrelenmiş bir görünümü CSV olarak dışa aktarabilir. Tek seferde en fazla 90 gün indirebilirsiniz. 60.000'den fazla hücre içeren indirmeler ise kısaltılır. Harita görünümü verilerinin CSV'ye aktarılması, seçilen zaman aralığına bağlı olarak birkaç dakika sürebilir.

İşletme analizleri metrikleri anonimleştirilir ve bu nedenle yalnızca haritalarınızla etkileşimdeki genel trendleri yansıtır. Düşük sayılar sıfıra yuvarlanabilir ve aykırı değerlerin katkıları azaltılabilir.

Haritalar Analytics iznini kullanarak Google Cloud Console'da Cloud projenizin işletme analizlerine erişimi kontrol edebilirsiniz. Proje sahiplerine varsayılan olarak bu izin verilir ve gerektiğinde diğer kullanıcılara erişim izni verebilirler.

İşletme Analizleri, kullanım maliyetlerinizi tahmin etmek için kullanılmamalıdır. Daha fazla kullanım bilgisi için lütfen kullanım raporlarına göz atın.