Google Haritalar Platformu Raporlaması

Google Haritalar Platformu'ndaki raporlama özelliği, Google Cloud Console'da temel API kullanımı, kota ve fatura bilgilerini içeren önceden tanımlanmış bir dizi görsel rapor sunar. Yaptığınız API çağrılarının sayısını ve API kullanım kotalarına ne kadar yaklaştığınızı belirlemek ve faturalandırma kullanımınızı zaman içinde 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 isteklerin sayısını bildirir.
• Kota raporları: Kota kullanımını, dakika başına istek sayısına göre gruplandırılabilen grafiklerde raporlar. Seçilen API'lerin mevcut kota sınırları, kota kullanımı grafiklerinin altındaki tablolarda gösterilir.
• Fatura raporları: Zaman içindeki maliyetleri yığın çizgi grafik olarak raporlar. Geçerli ayın kota kullanımını (kullanıma özel krediler dahil) ve geçerli ayın tamamı için öngörülen toplam maliyeti görüntüleyin.

Bir isteğin Kullanım, Kota ve Faturalandırma raporlarında görünüp görünmeyeceğini belirleyen 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 istek sayısına göre belirlenir. İstekler arasında başarılı istekler, sunucu hatalarına neden olan istekler ve istemci hatalarına neden olan istekler yer alır. Kimlik bilgileri, API anahtarlarını ve istemci kimliklerini (Premium Plan ve taşınan Premium Plan projeleri için) içerir. Ayrıntılar için Premium Plan'a Genel Bakış başlıklı makaleyi ve istemci kimliği kullanmayla ilgili bilgileri inceleyin.

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 şu yöntemlerle filtreleyebilir ve gruplandırabilirsiniz:

  • Döneme ve API'ye göre filtreleyin.
  • Trafik, hata ve gecikme verilerini yanıt kodu, API ve kimlik bilgisine göre gruplandırılmış olarak görebilirsiniz.

• Belirli bir API: Belirli bir API'nin kullanım metriklerini şu yöntemlerle filtreleyip gruplandırabilirsiniz:

  • Döneme, API sürümlerine, kimlik bilgilerine ve yöntemlere göre filtreleme yapabilirsiniz.
  • Trafiği, hataları ve gecikmeyi yanıt koduna, API yöntemine, sürümüne ve kimlik bilgisine göre gruplandırılmış olarak görebilirsiniz.

API'ler ve Hizmetler Kontrol Paneli sayfası

API'ler ve Hizmetler Kontrol Paneli, projeniz için etkinleştirilen tüm API'lerin (Google Haritalar Platformu API'leri ve diğer API'ler ile 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) cinsinden 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 ortanca gecikmesini gösterir.

Grafiklerin altındaki tabloda, etkin API'ler ve hizmetler listelenir. İstekler, seçilen dönemdeki isteklerin sayısıdır. Hatalar, bu isteklerden hatayla sonuçlananların sayısıdır. Gecikme (orta gecikme ve yüzdelik dilim), bu isteklerin gecikme süresidir.

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 ve ardından API'ler ve Hizmetler'i seçin.

Daha fazla bilgi için API kullanımınızı izleme 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 biçiminde gösterilir. Faturalandırma grafiğinde, mevcut faturanız ve son 3 aya ait toplam kullanımınız gösterilir.

Google Haritalar Platformu 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. Sol menüden 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 temsil eden kutulardan oluşan bir tablo bulunur. Her kartta Etkinleştir veya Devre dışı bırak'ı seçerek ilgili hizmeti etkinleştirebilir ya da devre dışı bırakabilirsiniz. Ayrıca, etkinleştirilen API'lerin kimlik bilgileri, metrikleri ve kullanıcı rehberlerine erişebilirsiniz. Etkinleştirilmiş 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'leri ve Hizmetleri 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üde 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ı, API, API yöntemi, kimlik bilgisi, platform ve alan adına göre gruplandırılabilir.

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

Üst kısımdaki API açılır menüsünü ve sağ paneldeki gruplandırma ve filtreleme seçeneklerini kullanarak, belirli veya birden fazla API, kimlik bilgisi, yanıt kodu sınıfı, platform türü ve alan seçerek görüntülenen kullanım metriklerini gruplandırabilir ve filtreleyebilirsiniz. Ayrıca, görüntülenen 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) seçebilirsiniz.

Aşağıdaki resimlerde, Gruplandırma ölçütü açılır listesinde Platform ve Alan'a göre gruplandırma seçildiğinde belirli 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 raporlama

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

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 ayırır. Bu tabloda, Google Haritalar Platformu API yanıt durumu ile HTTP yanıt kodu sınıfı arasındaki eşleme gösterilmektedir:

¹ Hata kodu raporlamanın tutarlılığını artırmak için Google Haritalar Platformu API'leri şu şekilde taşınıyor: 1) Haritalar API durumları için HTTP yanıt kodu sınıfı 2xx'den 4xx'e: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - status, 2) Haritalar API durumları için HTTP yanıt kodu sınıfı 2xx'den 4xx'e: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded, 3) Haritalar API durumu için HTTP yanıt kodu sınıfı 2xx'den 5xx'e: UNKNOWN_ERROR. Geçiş döneminde her iki yanıt kodunu da görebilirsiniz. Maps API yanıtlarında döndürülen yanıt kodları değişmez. Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx artışının bu taşıma işlemiyle ilgili olduğunu doğrulamak için Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol edin (Google Haritalar Platformu için Google Cloud Monitoring'i 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 belgelerine (ör. Geocoding Responses veya Directions Responses) bakın.

Google Haritalar Platformu kullanım ilişkilendirme parametresi

Google Haritalar Platformu, hızlı bir şekilde çalışmaya başlamanıza yardımcı olmak için birçok türde örnek kod sunar. Örneğin, Cloud Console'da Quick Builder'ı kullanabilir, sektör çözümleri uygulama kılavuzlarını takip edebilir ve codelab'lerden bilgi edinebilirsiniz.

Google, çözümlerimizin kullanımını ve iyileştirme yollarını anlamak için API çağrılarına internal_usage_attribution_ids parametresini ekleyerek örnek kod kullanımı hakkında bilgi toplar:

• internal_usage_attribution_ids parametresi, çözüm örnek koduna varsayılan olarak dahil edilebilir.
• Parametre, gelecekteki iterasyonlarda çözüm kalitesini artırmak için çözümün benimsenmesiyle ilgili analizleri Google'a döndürür.
• Örnek koddan internal_usage_attribution_ids parametresini ve değerini silerek bu özelliği devre dışı bırakabilirsiniz.
• Parametreyi tutma zorunluluğu yoktur. Parametrenin kaldırılması performansı etkilemez.
• Parametre yalnızca örnek kod kullanımı raporlaması için kullanılır.
• Parametre, API'ye özel analiz ve raporlamadan 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ırlamalar getirir. İstekler üç şekilde sınırlanabilir: günlük, dakikalık ve kullanıcı başına dakikalık. Yalnızca başarılı istekler ve sunucu hatalarına neden olan istekler kotaya dahil edilir. Kimlik doğrulaması başarısız olan istekler kotaya dahil edilmez.

Kota kullanımı, Cloud Console'daki Kotalar sayfasında grafikler halinde gösterilir ve dakika başına istek sayısına göre gruplandırılabilir. Seçilen API'lerin mevcut 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 istiyorsanız 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 kimlikleriniz için toplam trafiği gösterir. İstemci kimliği trafiği, Cloud Console'daki Metrikler grafiğinde de mevcuttur.

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) ve UNKNOWN_ERROR).

İstemci 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ı)]) kota 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 (Eski), Places API, Time Zone API, Geolocation API ve Elevation API) için bir istektir ancak bazı istisnalar vardır:

• Distance Matrix API (Eski) için kota birimi, başlangıç-varış noktası çifti olan bir öğedir.
• Maps JavaScript API için kota birimi, harita yüklemedir.
• Android için Haritalar SDK'sı ve iOS için Haritalar SDK'sı için kota birimi, Street View isteği veya panorama yüklemesidir. Harita yüklemeleri ücretsizdir ve kota 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'lerinin kota birimi gösterilmektedir.

Fatura raporları

Fatura raporunuzu görüntüleme

Google Haritalar Platformu ürünlerini kullanımınızla ilgili fatura raporlarını Google Cloud Console'da bulabilirsiniz. Daha fazla bilgi için Faturalandırma başlıklı makaleyi inceleyin.

Fatura 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 soldaki menüden Raporlar'ı seçin.

Fatura raporu grafiğini okuma

Fatura raporları, zaman içindeki maliyeti yığın çizgi grafik olarak gösterir. Varsayılan görünüm, geçerli ayın günlük kullanıma özel maliyetlerini projeye göre gruplandırılmış şekilde (tüm ürünler için) gösterir. Bu maliyetlere, uygulanan kullanıma özel krediler ve geçerli ayın tamamı için tahmini toplam maliyet dahildir. Grafikteki her çizgi (ve özet tablosundaki satır), maliyete göre en yüksekten en düşüğe doğru sıralanan projeye karşılık gelir. Fatura raporu grafiğini yorumlama hakkında daha fazla bilgi edinin.

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

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

Raporlama görünümünü, satır öğelerini SKU'ya göre gösterecek şekilde değiştirmek için:

1. Grafiğin sağındaki panelde Gruplandırma ölçütü filtresini genişletin.
2. SKU'yu seçin.

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

Kullanımınızın kaynağını ürüne ek olarak kategorize etmek için fatura 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 (bir API anahtarının son dört karakteri), goog-maps-platform-type (platform: Android, iOS, JavaScript veya web hizmeti) ve goog-maps-channel (bir API sorgusundan alınan ayarlanmış sayısal kanal değeri). Filtreleme ve gruplandırma hakkında daha fazla bilgi

Sağ paneldeki Maliyete kredileri dahil et onay kutusunun işaretini kaldırarak grafiği 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:

• Bütçe belirleyin

  uyarı: Harcamanızın belirli bir tutara doğru nasıl arttığını takip etmek için kullanılır. Bütçe, API kullanımını sınırlamaz. Yalnızca harcama tutarınız belirtilen tutara yaklaştığında sizi uyarır.

• Günlük API'nizi sınırlama

  Kullanım: Faturalandırılabilir API'lerin kullanım maliyetini yönetmek için kullanılır. Günlük istek sayısına sınır koyarak harcamanızı sınırlayabilirsiniz. Harcamak istediğiniz tutara göre günlük sınırınızı belirlemek için bir denklem kullanın. Örneğin: (Aylık harcama / her bir SKU'nun 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ı kullanarak izlemek için API isteklerinize "channel" parametresini eklemeniz gerekir. Kabul edilebilir tek kanal değerleri 0-999 arasındaki sayılardır. 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 fatura raporunuzdan izleyebilirsiniz. Kanal kullanımı, Etiketler bölümünde goog-maps-channel anahtarı olarak gösterilir.

Fatura raporunuzu SKU ve kanala göre filtrelemek için:

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

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

İsteklerinizde kanal kullanım verilerini uyguladıktan sonra, verilerin fatura raporunuza yansıtılması kısa bir süre (24 saate kadar) gecikebilir.

Faturalandırma verilerinizi BigQuery'ye aktarma

Ayrıca faturalandırma verilerinizi BigQuery'ye aktarabilirsiniz.

Ayrıntılı Cloud Billing verilerini (ör. kullanım ve maliyet tahmini verileri) gün boyunca otomatik olarak belirttiğiniz bir BigQuery veri kümesine aktarmak için BigQuery Export'u kullanın. 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 şunları yapmanız gerekir:

• 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ıdır. "gcp_billing_exportv1" ön ekini alır ve tireler (-) alt çizgi (_) olarak 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
  

İ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
• Fatura 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 Faturalandırması
• Optimizasyon Rehberi
• API anahtarıyla ilgili en iyi uygulamalar

Yanıt durumu ve raporlar

Aşağıdaki tabloda, Maps API durumu, Maps 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üzeyi sağlar. Daha ayrıntılı bilgiye ihtiyacınız varsa Yanıt durum kodları bölümüne bakın.

Google Haritalar Platformu kullanım izleme bölümünde bulabilirsiniz.