Google Haritalar Platformu Raporlaması

Google Haritalar Platformu'nda raporlama, Google Cloud Console'da temel API kullanımı, kota ve faturalandırma bilgilerine dair önceden tanımlanmış bir dizi görsel rapor sunar. Yaptığınız API çağrısı sayısını, API kullanım kotalarına ne kadar yakın olduğunuzu 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ı: Projenizle ilişkili kimlik bilgilerini kullanarak projenizin Google Haritalar Platformu API'lerine yaptığı isteklerin sayısını bildirir.
• Kota raporları: Dakika başına istek bazında gruplanabilen grafikler halinde kota kullanımını bildirir. 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ığınlı çizgi grafik olarak raporlar. Uygulanan kullanıma özel krediler dahil olmak üzere geçerli ayın kota kullanımını ve geçerli ayın tamamı için tahmini toplam maliyeti görüntüleyin.
• scienceEtkileşim raporları: Kullanıcıların harita uygulamalarınızla nasıl etkileşimde bulunduğuna dair 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ı bölümüne bakın.

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

Kullanım raporları

Kullanım, projenizin projenizle ilişkilendirilen kimlik bilgilerini kullanarak Google Haritalar Platformu API'lerine yaptığı istek sayısına bağlıdır. İ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 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ış ve istemci kimliği kullanma hakkında bilgi edinin.

Kullanım metrikleri, tablolar (İstekler, Hatalar ve Gecikme) ile grafikler (Trafik, Hatalar ve Gecikme) olarak 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.
  • Yanıt kodu, API ve kimlik bilgilerine göre gruplandırılmış trafik, hata ve gecikme değerlerini görün.

• Belirli bir API: Belirli bir API'nin kullanım metriklerini şu yöntemler ile filtreleyebilir ve gruplandırabilirsiniz:

  • Zaman aralığına, API sürümlerine, kimlik bilgilerine ve yöntemlere göre filtreleyin.
  • Yanıt kodu, API yöntemi ve sürümü ile kimlik bilgilerine göre gruplandırılmış trafik, hata ve gecikme süresini görün.

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'lerinin yanı sıra diğer API ve hizmetlerin) kullanım metriklerine genel bir bakış sunar.

• Kontrol paneli sayfasında üç grafik ve bir tablo bulunur. Grafik ve tablolarda gösterilen kullanımı, 1 saat ile son 30 gün arasında bir dönem seçerek filtreleyebilirsiniz.

• Trafik grafiği, API başına saniyedeki sorgu (QPS) değerini gösterir.

• Hatalar grafiğinde, API başına hataya neden olan isteklerin yüzdesi gösterilir.

• Gecikme grafiği, API başına isteklerin ortanca değerini gösterir.

Grafiklerin altındaki bir tabloda, etkin API'ler ve hizmetler listelenmiştir. İstekler, istek sayısıdır (seçilen dönem için). Hata sayısı, hataya neden olan bu isteklerin 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 ve ardından API'ler ve Hizmetler'i seçin.

Daha fazla bilgi için API Kullanımınızı İzleme bölümüne bakın.

Google Haritalar Genel Bakış sayfası

Google Haritalar Genel Bakış sayfasında, etkinleştirilmiş API'lerin ve son 30 güne ait kullanım isteklerinin listelendiği bir tablo yer alır. API'ye göre istekler de grafik biçiminde gösterilir. Faturalandırma grafiği mevcut faturanızı ve son 3 aydaki toplam kullanımınızı gösterir.

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 git

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

Google Haritalar Platformu API'leri sayfası

Google Haritalar API'leri sayfasında iki tablo bulunur. Etkin API'ler tablosunda istek sayısı, hata sayısı ve etkinleştirilen her bir API'nin son 30 gündeki ortalama gecikme süresi gösterilir. Etkinleştirilmemiş API'ler Ek API'ler tablosunda listelenir.

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

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

   Google Haritalar Platformu sayfasına git

2. Soldaki menüden API'ler seçeneğini belirleyin.

Google Haritalar Metrikler sayfası

Google Haritalar Metrikler sayfasında üç grafik gösterilir: Trafik, Hatalar ve Ortanca Gecikme. Grafiklerdeki kullanım verileri; Yanıt Kodu sınıfı, API, API yöntemi, Kimlik Bilgisi, Platform ve Alana göre gruplandırılabilir.

Grafiklerin altında Metrikler sayfası, seçtiğiniz API'lerle ilgili istekleri, hataları ve gecikmeyi gösteren bir API tablosu içerir.

Üstteki API açılır listesini ve sağ bölmedeki 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. 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, Platform'a göre gruplama yapıldığında ve Gruplandırma ölçütü açılır listesinde Alan 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 git

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

Kimlik bilgisi raporlaması

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

Kimlik bilgisi biçimi	Anlamı
Anahtar adı Örneğin, "Mobil uygulama anahtarı"	?key=... kullanarak API'yi yüklemek için bir API anahtarı kullanıldı: Anahtar adlarını Haritalar Platformu Konsolu'nda Anahtarlar ve Kimlik Bilgileri altında bulabilirsiniz.
Proje Numarası Örneğin, "proje_numarası:123456" (burada 123456 proje numaranızdır).	Bu kimlik bilgisini görüyorsanız iki olasılık vardır: Haritalar Platformu istemci kimliklerini kabul eden API'ler için: API'yi yüklemek üzere bir Haritalar Platformu istemci kimliği kullanılmıştır. Örneğin, &client=gme-_mycompany_ kullanılarak. Bu API'ler şu 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 sayfasına göz atın. OAuth'u kabul eden API'ler için: API, API anahtarı olmadan OAuth kullanılarak yüklenmiştir.

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 Maps Platform 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ı kullanır.
Tamam	3xx	Başarılı yanıt. Bu faturalandırılabilir bir istektir ve kotayı kullanır. Örneğin, başarılı Yer Fotoğrafı istekleri, referans verilen resme 302 yönlendirmesi döndürür.
DATA_NOT_AVAILABLE	4xx(1)	Giriş konumları için kullanılabilir veri olmadığını belirten başarılı yanıt. Bu faturalandırılabilir bir istektir ve kotayı kullanır.
ZERO_RESULTS	4xx(1)	Başarılı yanıt hiçbir sonuç döndürmedi. Bu faturalandırılabilir bir istektir ve kotayı kullanır.
NOT_FOUND	4xx(1)	Directions API için bu mesaj, isteğin başlangıç, hedef veya ara noktalarında belirtilen konumlardan en az birinin coğrafi kodlamasının yapılamadığını gösterir. Places API için bu mesaj, başvurulan konumun (place_id) Yerler veritabanında bulunamadığını gösterir. Bu faturalandırılabilir bir istektir ve kotayı kullanır.
INVALID_REQUEST (geçersiz parametre değeri), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED ve diğerleri.	4xx	Geçersiz parametre değeri nedeniyle hata. Daha fazla ayrıntı için API yanıtını kontrol edin. Bu faturalandırılabilir bir istektir ve kotayı kullanır.
REQUEST_DENIED	4xx	Kimlik doğrulama hatası, erişim hatası ve diğer nedenlerden kaynaklanan istemci hatası. Daha fazla ayrıntı için API yanıtını kontrol edin.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, KAYNAK_EXHAUSTED, RateLimitExceeded, DailyLimitExceeded, userRateLimitExceeded	4xx	İzin verilen dönem başına çok fazla istekten kaynaklanan istemci hatası. İsteği daha sonra yeniden deneyin. Daha fazla ayrıntı için API yanıtını kontrol edin.
INVALID_REQUEST (geçersiz veya eksik parametre, ayrıştırma veya doğrulama hatası isteğinde bulunun)	4xx	Geçersiz istekten kaynaklanan istemci hatası. Daha fazla ayrıntı için API yanıtını kontrol edin.
NOT_FOUND (404)	4xx	Geolocation 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 tutturulamadığını gösterir. Bu faturalandırılabilir bir istektir ve kotayı kullanır.
UNKNOWN_ERROR	5xx	İsteğin işleme alınamayacağını belirten sunucu hatası: dahili hata, hizmet aşırı yüklendi, kullanılamıyor, zaman aşımı vb.
1 Hata kodu raporlamasının tutarlılığını artırmak amacıyla Google Maps Platform API'leri, {1) Haritalar API'si durumları için 2xx HTTP yanıt kodu sınıfından 4xx sürümüne taşınıyor: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - durum, 2) Maps API durumları için 2xx HTTP yanıt kodu sınıfından 4xx sürümüne: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, rateLimitExceeded ve rateLimitExceeded için HTTP API durumu: 2xx API durumu: 2xx API durumu: 2xx API durumu: rateLimitExceeded, {11)userRateLimitExceeded5xxUNKNOWN_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şmemektedir. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx metriğindeki artışın bu taşımayla ilgili olduğunu onaylayın (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 edinmek için ilgilendiğiniz API'nin yanıt dokümanlarına bakın (örneğin, Yanıtların Coğrafi Kodlaması veya Yol Tarifi Yanıtları).

Google Haritalar Platformu çözümleri parametresi

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

Kullanımı ve çözümlerimizi iyileştirmenin yollarını anlamak için Google, ö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ün benimsenmesiyle ilgili analizleri döndürür.
• solution_channel sorgu parametresini ve değerini örnek koddan silerek bu özelliği 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 özel tüm analizlerden ve raporlamadan ayrıdır. Bu, parametrenin çözüm örnek kodundan kaldırılmasının, dahili Maps JavaScript API raporlamasını devre dışı bırakmadığı anlamına gelir.

Kota raporları

Kotalar, projenizin Google Maps Platform API'lerine gönderebileceği istek sayısını sınırlandırır. İstekler üç şekilde sınırlanabilir: günlük, dakika ve kullanıcı başına dakika. Yalnızca sunucu hatalarına neden olan başarılı istekler ve istekler kotaya dahil edilir. Kimlik doğrulamada başarısız olan istekler kotaya dahil edilmez.

Kota kullanımı, Cloud Console'daki Kotalar sayfasında yer alan grafiklerde 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ünde dakika başına kota değerinizi öğrenmek için bu hesap makinesini kullanın.

Google Haritalar Kotalar sayfası

Google Haritalar Kotalar sayfasında, seçtiğiniz belirli 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 bulunur.

Sayfada yalnızca kota kullanan 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).

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ı)) gibi istemci hatalarına neden olan istekler kotayı kullanmaz ve gösterilmez.

Kota birimi, çoğu Google Haritalar Platformu API'si (Haritalar Statik 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'si için kota birimi, kaynak-hedef çifti olan bir öğedir.
• Maps JavaScript API için kota birimi bir harita yüküdür.
• Android için Haritalar SDK'sı ve iOS için Haritalar SDK'sının kota birimi, Street View isteği veya Panorama yüküdür. Harita yüklemeleri ücretsiz olarak kullanılabilir ve kotayı kullanmaz.

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 git

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

Kota birimleri

Bu tablo, Google Haritalar Platformu API'leri için kota birimini gösterir.

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 İstek
Haritalar Aerial View API	1 İstek
Maps Static API	1 İstek
Maps JavaScript API	1 Harita Yüklemesi
Street View Static API	1 İstek
Maps Embed API	1 Harita Yüklemesi
Rotalar
Routes API (Compute Rotaları)	1 İstek
Routes API (Compute Route Matrisi)	1 Öğe (kaynak-hedef çifti)
Directions API	1 İstek
Distance Matrix API	1 Öğe (kaynak-hedef çifti)
Roads API	1 İstek
Rota Optimizasyonu API'si	1 İstek
Yerler
Places API	1 İstek
Address Validation API	1 İstek
Geocoding API	1 İstek
Geolocation API	1 İstek
Time Zone API	1 İstek
Ortam
Air Quality API (CurrentConditions ve HeatmapTile)	1 İstek
Hava Kalitesi API'sı (Geçmiş)	1 sayfa
Pollen API	1 İstek
Solar API	1 İstek

Fatura raporları

Fatura raporunuzu görüntüleme

Google Haritalar Platformu ürünlerini kullanımınızla ilgili faturalandırma raporlarına Google Cloud Console'da ulaşabilirsiniz. Daha fazla bilgi için Faturalandırma bölümünü 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 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üde Raporlar'ı seçin.

Fatura raporu grafiğini okuma

Faturalandırma raporları, zaman içindeki maliyeti yığınlı çizgi grafik olarak gösterir. Varsayılan görünüm, uygulanan kullanıma özel krediler ve geçerli ayın tamamı için tahmini toplam maliyet dahil olmak üzere, projeye göre gruplanmış (tüm ürünler için) geçerli ayın günlük kullanıma özgü maliyetlerini gösterir. Grafikteki her satır (ve özet tablosundaki satır) projeye karşılık gelir. Maliyetler en büyükten en düşüğe doğru sıralanır. Faturalandırma raporu grafiğini yorumlama hakkında daha fazla bilgi

İ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ınıza ve maliyete bakın.

Rapor 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 faturalandırma raporu filtreleri arasında API isteklerinin sunulduğu yere göre filtreleme yapmanızı sağlayan Zaman aralığı, Projeler, Ürünler, SKU'lar ve Konumlar yer alır.

Ürüne ek olarak kullanımınızın kaynağını 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 (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 sayısal bir sayısal kanal değeri). Filtreleme ve gruplandırma hakkında daha fazla bilgi edinin.

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 maliyetlerinizi kontrol etmenize yardımcı olması için aşağıdakileri yapabilirsiniz:

• Harcamanızın belirli bir tutara doğru nasıl büyüdüğünü izlemek için bütçe uyarısı ayarlayın. Bütçe ayarlamak API kullanımını sınırlamaz, yalnızca harcama tutarınız belirtilen tutara yaklaştığında sizi uyarır.

• Faturalandırılabilir API'lerin kullanım maliyetini yönetmek için günlük API kullanımınızı sınırlandırın. Günlük istek sayısını sınırlayarak 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 takibi

Kullanımınızı sayısal kanallar üzerinden takip etmek için API isteklerinize "channel" parametresini eklemeniz gerekir. Kabul edilen tek kanal değerleri 0-999 arasındaki sayılardır. Aşağıda birkaç örnek verilmiştir:

• Coğrafi Kodlama Web Hizmeti API'si

  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'in altında goog-maps-channel olarak görünür.

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

1. SKU filtresini Gruplandırma ölçütü olarak kullanın.
2. Etiketler düzeltme işaretini seçin.
3. Key (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 bir kanalın oluşturduğu maliyeti görmek için goog-maps-channel Etiket anahtarına göre gruplandırın.

Kanal kullanım verilerini isteklerinize uyguladıktan sonra verilerin faturalandırma raporunuza yansımasında kısa bir gecikme (24 saate kadar) olabilir.

Faturalandırma verilerinizi BigQuery ile dışa aktarma

Faturalandırma verilerinizi BigQuery'ye de aktarabilirsiniz.

BigQuery Export, 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'deki faturalandırma verilerinize erişebilirsiniz. Bu, Google Haritalar Platformu kullanımınızın kaynağını anlama konusunda ekstra bir ayrıntı katmanı sağlar.

BigQuery dışa aktarma işlemlerini 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 aktarımını 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, "gcp_billing_exportv1" önündeki ve kısa çizgileri (-) alt çizgi (_) olarak değiştiren, Faturalandırma Hesabı Kimliğinize ait bir referanstır. Ö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
• Projelerin 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 Maps API durumu, Maps API yanıtlarında döndürülen HTTP yanıt kodu ile 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 belirtilmektedir.

Google Haritalar Platformu Metrikleri'ndeki Kullanım Raporu HTTP response code class ayrıntı düzeyi sağlar. Daha yüksek bir ayrıntı düzeyine ihtiyacınız varsa Google Haritalar Platformu Kullanım izlemesi bölümünde bulunan Yanıt durumu kodları'nı inceleyin.

Maps API yanıtlarında kullanılabilen yanıt kodları		Kullanım Raporu'nda mevcut	Bildirilen hesap:
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, ayrıştırma hatası isteği)	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, KAYNAK_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ı artırmak amacıyla Google Maps Platform API'leri, {1) Haritalar API'si durumları için 2xx HTTP yanıt kodu sınıfından 4xx sürümüne taşınıyor: DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - durum, 2) Maps API durumları için 2xx HTTP yanıt kodu sınıfından 4xx sürümüne: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, rateLimitExceeded, rateLimitExceeded ve rateLimitExceeded için HTTP API durumu: 2xx API durumu: 2xx API durumu: 2xx API durumu: rateLimitExceeded, {11)userRateLimitExceeded5xxUNKNOWN_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şmemektedir. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx metriğindeki artışın bu taşımayla ilgili olduğunu onaylayın (Google Haritalar Platformu için Google Cloud Monitoring'i 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 analizlere, haritada görüntüleme veya ÖY ile etkileşimler gibi önemli etkileşim metrikleri dahildir. Reklamcılık ve pazarlama için popüler konumları belirlemek veya kullanıcı deneyiminizi optimize etmek için bu bilgileri analiz edebilirsiniz.

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

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

Kullanabileceğiniz etkileşim metrikleri şunlardır:

• Harita Görünümleri: Kaydırma, yakınlaştırma ve eğme işlemlerinden kaynaklanan görünümleri takip edin. Harita Görünümleri haftalık olarak posta kodu kullanılarak hesaplanır (Pasifik saatiyle pazardan cumartesiye). Yeni veriler, gözlem döneminden sonraki ilk Çarşamba günü yayınlanır.

Kullanıcılar, iş analizlerini Cloud Console'daki Metrikler sayfasında görüntüleyebilir. Projede Haritalar JavaScript API etkinleştirilmiş olmalıdır.

Metrikleri daha ayrıntılı incelemek için Filtreleme ve Gruplama Ölçütü özellikleriyle etkileşim metriklerini doğrudan konsolda analiz edebilirsiniz. Örneğin, belirli bir bölgeye göre filtrelemeyi seçerek harita görüntülemelerinin yalnızca ilgili bölgedeki posta kodları için gösterdiği trendi öğrenebilirsiniz. Diğer yandan, belirli bir bölge içindeki etkileşimleri toplamak için bölgeye göre gruplandırma yapmak isteyebilirsiniz.

Kullanıcılar, favori işletme analizi aracınızda daha ayrıntılı analizler yapmak için veri kümesinin tamamını veya filtrelenmiş bir görünümü CSV'ye aktarabilir. Tek seferde en fazla 90 gün boyunca içerikleri indirebilirsiniz. 60 bin hücreden büyük boyutlu indirmeler kesilir. Harita görünümü verilerinin CSV'ye aktarılması, seçilen zaman aralığına bağlı olarak birkaç dakika sürebilir.

İşletme analizi metrikleri anonimleştirilir ve bu nedenle yalnızca haritalarınızla etkileşimle ilgili genel trendleri yansıtır. Düşük sayılar sıfıra yuvarlanabilir ve aykırı değerlerden gelen katkılar azalabilir.

Maps Analytics iznini kullanarak Google Cloud Console'da Cloud projenizin iş analizlerine erişimi kontrol edebilirsiniz. Proje Sahipleri bu izni varsayılan olarak verir ve gerektiğinde diğer kullanıcılara da erişim sağlayabilir.

İş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 bakın.

Bulucu Plus

Locator Plus kullanıcıları, verilerinizi analiz edip analizler elde etmenizi sağlayan analiz kontrol paneli sayesinde, alışveriş yapanların mağaza bulma aracınızla ne kadar etkileşimde bulunduğuna dair net bir fikir edinebilir. Görüntüleme sayısı, Arama ve Yer Ayrıntıları ile etkileşim sayısı ve genel etkileşim oranı dahil olmak üzere performansınızı haftadan haftaya ölçebilirsiniz. Ayrıca kontrol paneli, uygulamanızın diğer perakendecilere kıyasla ne durumda olduğunu gösteren önemli karşılaştırmalar da sunar.

• Google Cloud Console'da Locator Plus'a gidin.
• Analiz kontrol panelini görmek için Google Cloud Console'un Etkileşim Raporları bölümüne gidin.

Karşılaştırma raporu, verilerinizi kendi verilerini paylaşan diğer şirketlere ait toplu sektör verileriyle karşılaştırmanıza olanak tanır. Karşılaştırma; anlamlı hedefler belirlemenize, sektör trendleri hakkında bilgi edinmenize ve rakiplerinize kıyasla nasıl performans gösterdiğinizi öğrenmenize yardımcı olarak değerli bağlamlar sunar.

Karşılaştırma verilerini görmek için etkileşim verileriniz Google karşılaştırmalarına anonim olarak dahil edilir. Etkileşim verilerinizi görüntüleme ve karşılaştırma raporlarına anonim olarak dahil etmeyi devre dışı bırakmak için destek kaydı oluşturun. Destek kaydı genellikle 3 gün içinde çözülür.