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.

izleme API'leri

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 menü 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ği, mevcut faturanızı ve son 3 aya ait toplam kullanımınızı gösterir.

Son 30 güne ait etkin API'leri ve API isteklerini listeleyen bir tabloyu gösteren Genel Bakış grafiğinin ekran görüntüsü.

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.

api

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.

Trafik, Hatalar ve Ortalama Gecikme olmak üzere üç grafiği gösteren metrik sayfası.

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:

Platform filtresi yalnızca tek bir API seçildiğinde gösterilir. Platform filtresi yalnızca tek bir API seçildiğinde gösterilir.

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:
  1. 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.

  2. OAuth'u kabul eden API'ler için: API, API anahtarı olmadan OAuth kullanılarak yüklendi.

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 kota 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önlendirme döndürür.
DATA_NOT_AVAILABLE 4xx(1) Giriş konumları için kullanılabilecek 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 kota 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 kota 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 kota 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 edilemediğ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ı olmak için birçok türde örnek kod sağlar. Örneğin, Cloud Console'da Hızlı Oluşturucu'yu kullanabilir, sektör çözümlerinin uygulama kılavuzlarını takip edebilir ve codelabs 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 dahildir.
  • 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 Cloud Console'daki Haritalar'ın Kotalar sayfasının ekran görüntüsü. Seçiciyi kullanarak API'ye göre kotaları gösterir, ardından söz konusu API için belirlenen kotalara göre Harita Yüklemeleri'ni gösterir.

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
Maps
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 menü 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 ve geçerli ayın tamamı için tahmini toplam maliyet 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.

Varsayılan hazır görüntüleme kullanılarak grafik ve tabloyu gösteren faturalandırma raporunun ekran görüntüsü
Ş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.

SKU'ya göre gruplandırılmış faturalandırma raporu
Şekil 2: SKU'ya göre kullanım ve maliyet satır öğelerini gösteren faturalandırma tablosu.
Faturalandırma raporu filtrelerinin ekran görüntüsü
Ş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.

Kullanılabilen 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 Maps Platform 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).

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.

Etiketlere göre filtreleme
Ş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.

  #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
  

Cloud Billing:

Google Haritalar Platformu:

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.

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 bölümündeki 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
4xx1 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
4xx1 Evet Hayır Hayır
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
RESOURCE_EXHAUSTED,
dailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200,
403,
429
4xx1 Evet Hayır Hayır
UNKNOWN_ERROR 200,
500,
503
5xx1 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ı

İşletme Analizleri

Google Haritalar Platformu, kullanıcıların haritalarınızla nasıl etkileşimde bulunduğuna dair analizler sunar. Bu analizler, haritadaki görüntülemeler 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, veri kümesinin tamamını veya filtrelenmiş bir görünümü CSV olarak dışa aktararak favori iş analiz aracında daha ayrıntılı analizler yapabilir. 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 analizlerini dışa aktarma

İş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.