Google Haritalar Platformu Raporlaması

Google Haritalar Platformu'ndaki raporlama özelliği, Google Cloud Console'daki temel API kullanımı, kota ve faturalandırma bilgilerini kolayca görmenize olanak tanıyan, önceden tanımlanmış bir dizi görsel rapor sağlar. API çağrılarının sayısını, API kullanım kotalarına ulaşmanıza ne kadar yaklaştığınızı ve zaman içindeki faturalandırma kullanımını izleyebilirsiniz.

Rapor türleri şunlardır:

  • Kullanım raporları: Projenizle ilişkili kimlik bilgilerini kullanarak projenizin Google Haritalar Platformu API'lerine yaptığı istek sayısını bildirir.
  • Kota raporları: Dakika başına istek sayısına göre gruplandırılabilen grafiklerde kota kullanımını bildirir. Seçili API'ler için geçerli kota sınırları, kota kullanım grafiklerinin altındaki tablolarda görüntülenir.
  • Faturalandırma raporları: Zaman içindeki maliyetleri yığın çizgi grafiği 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.
  • Etkileşim raporları: Kullanıcıların harita uygulamalarınızla nasıl etkileşim kurduğu hakkında işletme analizleri sağlayın.

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 aşağıdaki 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 ilişkili kimlik bilgilerini kullanarak Google Haritalar Platformu API'lerine yaptığı isteklerin 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, API anahtarlarını ve istemci kimliklerini içerir (Premium Plan ve taşınan Premium Plan projeleri için).

Kullanım metrikleri tablolarda (İstekler, Hatalar ve Gecikme) ve grafiklerde (Trafik, Hatalar ve Gecikme) görüntülenir. İzleme amaçlı olarak:

  • Tüm API'lerin kullanım metrikleri döneme ve API'ye göre filtrelenebilir. Ayrıca trafik, hata ve gecikmeyi yanıt kodu, API ve kimlik bilgilerine göre gruplandırılmış olarak görebilirsiniz.
  • Belirli bir API için kullanım metrikleri, döneme ve API'nin sürümlerine, kimlik bilgilerine ve yöntemlerine göre filtrelenebilir. Ayrıca trafik, hata ve gecikmeyi yanıt koduna, API yöntemine, sürümüne ve kimlik bilgilerine göre gruplandırılmış olarak görebilirsiniz.

API'ler ve Hizmetler Kontrol Paneli sayfası

API'ler ve Hizmetler Kontrol Paneli sayfasında, projeniz için 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ış sunulur.

Gösterge Tablosu sayfasında üç grafik ve bir tablo bulunur. Bir dönem (1 saatten son 30 güne kadar) seçerek grafiklerde ve tablolarda görüntülenen kullanımı filtreleyebilirsiniz.

Trafik grafiği, API başına saniyedeki sorgu sayısı (QPS) kullanımını gösterir. Hatalar grafiği, API başına hataya neden olan isteklerin yüzdesini gösterir. Gecikme grafiği, API başına istek sayısının ortanca değerini gösterir.

Grafiklerin altında, etkinleştirilen API'ler ve hizmetler bir tabloda yer alır. İstekler, seçilen dönem için istek sayısıdır. Hatalar, hataya neden olan isteklerin sayısıdır. Gecikme (orta gecikme süresi 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ünür.

    Sayfa görünmüyorsa menü düğmesini menü 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, etkin API'lerin ve son 30 güne ait kullanım isteklerinin listelendiği bir tablo yer alır. API tarafından yapılan istekler de grafik biçiminde gösterilir. Bir faturalandırma grafiği, mevcut faturanızı ve son 3 aya ait toplam kullanımınızı gösterir.

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

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. Soldaki menüden Genel bakış'ı seçin.

Google Haritalar Platformu API'leri sayfası

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

api'ler

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 gidin

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

Google Haritalar Metrikler sayfası

Google Haritalar Metrikler sayfasında üç grafik görüntülenir: Trafik, Hatalar ve Ortanca 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ı, seçtiğiniz API'lere ait istekleri, hataları ve gecikmeyi gösteren bir API tablosu içerir.

Üst kısımdaki API açılır listesini ve sağ bölmedeki gruplandırma ve filtreleme seçeneklerini kullanarak belirli veya birden fazla API, Kimlik Bilgisi, Yanıt Kodu sınıfı, 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 (saniyede veya gün başına) seçebilirsiniz.

Üç grafik gösteren metrikler sayfası: Trafik, Hatalar ve Ortanca Gecikme.

Aşağıdaki resimlerde, Gruplandırma ölçütü açılır listesinde Platform ve Alan'a göre gruplama yapıldığında tek bir API için Platform ve Alan filtreleri gösterilmektedir:

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

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. Soldaki menüden Metrikler'i seçin.

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. Aşağıdaki tabloda, Google Haritalar Platformu API'si 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 referans verilen resme 302 yönlendirmesi döndürür.
VERİ_YOK 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ı 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.
BULUNAMADI 4xx(1) Directions API için bu durum, isteğin başlangıç noktası, hedefi veya ara noktalarında belirtilen konumlardan en az birinin coğrafi kodlamasının uygulanamadığını belirtir.

Places API için bu durum, başvurulan 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 vb.
4xx Hataya geçersiz parametre değeri neden oldu. Daha fazla bilgi için API yanıtına göz atın.

Bu faturalandırılabilir bir istektir ve kotayı tüketir.
İSTEK REDDEDİLDİ 4xx Kimlik doğrulama hatası, erişim hatası vb. bir nedenden kaynaklanan istemci hatası. Daha fazla bilgi için API yanıtını kontrol edin.
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
SOURCE_EXHAUSTED,
rateLimitExceeded,
DailyLimitExceeded,
userRateLimitExceeded
4xx İzin verilen zaman dilimi başına çok fazla istekten kaynaklanan istemci hatası. İsteği daha sonra yeniden deneyin. Daha fazla bilgi için API yanıtına göz atın.
INVALID_REQUEST (geçersiz/eksik parametre, istek ayrıştırma/doğrulama hatası) 4xx Geçersiz istekten kaynaklanan istemci hatası. Daha fazla bilgi için API yanıtına göz atın.
NOT_FOUND (404) 4xx Geolocation API için bu durum, girişlerin konum tahmini oluşturmak için yeterli olmadığını gösterir.

Roads API için bu durum, girişlerin yollara makul şekilde tutturulamadığını gösterir.

Bu faturalandırılabilir bir istektir ve kotayı tüketir.
UNKNOWN_ERROR 5xx İsteğin gerçekleştirilemediğini gösteren sunucu hatası: dahili hata, hizmet aşırı yüklendi, kullanılamıyor, zaman aşımı vb.
1 Google Haritalar Platformu API'leri, hata kodu raporlamasının tutarlılığını iyileştirmek amacıyla: 1) Maps API durumları için 2xx HTTP yanıt kodu sınıfından 4xx değerine taşınıyor: Haritalar API durumu DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS - durum, 2) Maps API durumları için 2xx HTTP yanıt kodu sınıfından 4xx değerine: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, kod userRateLimitExceeded2xxrateLimitExceeded5xxUNKNOWN_ERROR Geçiş süresi boyunca 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'ndeki 4xx ve/veya 5xx artışlarını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 için ilgilendiğiniz API'nin yanıt dokümanlarına (örneğin, Coğrafi Kodlama Yanıtları veya Yol Tarifi Yanıtları) bakın.

Google Haritalar Platformu çözümleri parametresi

Google Haritalar Platformu, hemen kullanmaya başlamanıza yardımcı olmak için birçok örnek kod türü sağlar. Örneğin, Cloud Console'da Hızlı Oluşturucu'yu kullanabilir, sektör çözümleri uygulama kılavuzlarını takip edebilir ve codelab'lerden bilgi edinebilirsiniz.

Kullanımı anlamak ve çözümlerimizi geliştirme yolları için Google, örnek kod kullanımı hakkında bilgi toplamak amacıyla API çağrılarına solution_channel sorgu parametresini dahil eder:

  • solution_channel sorgu parametresi varsayılan olarak çözüm örnek koduna dahil edilir.
  • Sorgu parametresi, gelecekteki yinelemelerde çö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 saklama 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 analiz ve raporlardan ayrıdır. Bu, parametrenin çözüm örnek kodundan kaldırılması, dahili Maps JavaScript API raporlamasının devre dışı bırakılmasına neden olmaz.

Kota raporları

Kotalar, projenizin Google Haritalar Platformu API'lerine gönderebileceği istek sayısını sınırlar. İstekler üç şekilde sınırlandırılabilir: günlük, dakika ve kullanıcı başına dakika. 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ındaki grafiklerde gösterilir ve dakika başına istek sayısına göre gruplandırılabilir. Seçili API'ler için geçerli kota sınırları, kota kullanım grafiklerinin altındaki tablolarda görüntülenir.

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

Google Haritalar Kotalar sayfası

Google Haritalar Kotalar sayfasında, seçtiğiniz belirli API için 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), UNKNOWN_ERROR).

İstemci hatalarına (kimlik doğrulama/yetkilendirme/geçersiz bağımsız değişken hataları) neden olan istekler (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 (Haritalar Statik API'si, Street View Static API, Coğrafi Kodlama API'si, Yol Tarifi API'si, Places API, Time Zone API, Geolocation API ve Elevation API) çoğu için bir istektir. Ancak bazı istisnalar söz konusudur:

  • 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ında kota birimi bir Street View isteği/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ü. Rapor, bir seçici kullanarak API'ye göre kotaları gösterir ve ardından söz konusu API için belirlenen kotalara göre Harita Yüklerini 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. Soldaki menüde Kotalar'ı seçin.
  3. API açılır listesinden bir API seçin.

Kota birimleri

Aşağıdaki 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
Haritalar Havadan Görünümü API'si 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 Routes) 1 İstek
Routes API (Compute Route Matrix) (İşlem Rota Matrisi) 1 Öğe (kaynak-hedef çifti)
Directions API 1 İstek
Distance Matrix API 1 Öğe (kaynak-hedef çifti)
Roads API 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
Air Quality API (Geçmiş) 1 sayfa
Güneş Enerjisi API'si 1 İstek

Faturalandırma raporları

Faturalandırma raporunuzu görüntüleme

Google Haritalar Platformu ürünlerini kullanımınızla ilgili faturalandırma raporlarına Google Cloud Console'dan ulaşabilirsiniz (bkz. Faturalandırma).

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ü ve ardından Faturalandırma'yı seçin.
  4. Birden fazla faturalandırma hesabınız varsa Bağlı faturalandırma hesabına git'i seçerek bağlı faturalandırma hesabının Genel Bakış sayfasını açın.
  5. Bağlı faturalandırma hesabının faturalandırma Raporlar sayfasını açmak için soldaki menüde Raporlar'ı seçin.

Faturalandırma raporu grafiğini okuma

Faturalandırma raporları, zaman içindeki maliyeti yığılmış çizgi grafik olarak gösterir. Varsayılan görünüm, geçerli ayın günlük kullanıma özgü maliyetlerini, uygulanan kullanıma özel krediler dahil olmak üzere projeye göre gruplanmış (tüm ürünler için) ve geçerli ayın tamamı için tahmini toplam maliyeti gösterir. Grafikteki (ve özet tablosundaki satır) her satır, maliyete göre en büyükten en düşüğ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 ayar görünümünü kullanan grafik ve tabloyu gösteren faturalandırma raporunun ekran görüntüsü
Şekil 1: Varsayılan hazır ayar görünümünü kullanan grafik ve tabloyu gösteren faturalandırma raporu.

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

Kullandıkça öde fiyatlandırma modelinin ayrıntılarını ve bu modelin uygulamanızı nasıl etkilediğini daha doğru anlamak için SKU'ya göre kullanımınıza 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.
Rapor görünümünü SKU'ya göre satır öğelerini görüntüleyecek ş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 Zaman aralığı, Projeler, Ürünler, SKU'lar ve Konumlar yer alır. Bu filtreler, API isteklerinin sunulduğu yere göre filtreleme yapmanıza olanak tanı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 (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 elde edilen sayısal kanal değeri). Filtreleme ve gruplandırma hakkında daha fazla bilgi edinin.

Sağ paneldeki Maliyete kredi dahil et onay kutusunun işaretini kaldırarak kullanıma özel kredileri hariç tutmak için grafik görünümünü değiştirebilirsiniz.

Tüketimi izleyin ve kısıtlayın

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

  • Harcamanızın belirli bir tutara doğru nasıl arttığını izlemek için bütçe uyarısı oluşturun. 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ırlayın. Günlük istek sayısı için sınır belirleyerek harcamanızı sınırlayabilirsiniz. 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: (Her SKU başına aylık harcama /fiyat)/30 = günlük istek sınırı (bir API için). Uygulamanızda birden fazla faturalandırılabilir API kullanılabileceği için denkleminizi gerektiği gibi düzenleyin. Size her ay 200 ABD doları değerinde Google Haritalar Platformu kredisi verildiğini unutmayın. Bu nedenle, hesaplamanızda bunu mutlaka göz önünde bulundurun.

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. Kabul edilen tek kanal değerleri 0-999 arasındaki sayılardır. Birkaç örnek verelim:

  • 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 Raporunuzda izleyin. Kanallar, Etiketler'in altında temel goog-maps-channel olarak görünür.

Etiketlere Göre Filtrele
Şekil 4: SKU ve Kanallara Göre Filtreleme
Faturalandırma raporunuzu SKU ve kanala göre filtrelemek için
  1. Gruplandırma ölçütü SKU filtresini kullanın.
  2. Etiketler düzeltme işaretini seçin.
  3. Key (Anahtar) açılır menüsünü ve ardından goog-maps-channel'ı seçin.
  4. Değer açılır listesini ve 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.

Kanal kullanım verilerini isteklerinize ekledikten sonra, verilerin faturalandırma raporunuza yansıması için 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) gün boyunca otomatik olarak belirttiğiniz bir BigQuery veri kümesine aktarmanıza olanak tanır. Ardından, ayrıntılı analiz için BigQuery'den faturalandırma verilerinize erişebilirsiniz. Bu, Google Haritalar Platformu kullanımınızın kaynağını anlamada daha fazla ayrıntı düzeyi 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 biçimindedir. Burada:
    • PROJECT_ID, gerçek proje kimliğinizdir (ör. "my-project-123456").
    • DATASET_NAME, oluşturduğunuz veri kümesinin adıdır (ör. "SampleDataSet").
    • BILLING_ACCOUNT_ID, Faturalandırma Hesabı Kimliğinizin bir referansıdır. Kimliğin başında "gcp_billing_exportv1" bulunur ve kısa çizgileri (-) alt çizgi (_) olarak değiştirir. Ö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 Faturalandırması:

Google Haritalar Platformu:

Yanıt durumu ve raporları

Aşağıdaki tabloda, Haritalar API'si durumu, Haritalar API'si 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österilmiştir ve 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ı izleme'de bulunan Yanıt durumu kodları konusuna bakın.

Google Maps API yanıtlarında kullanılabilen yanıt kodları Kullanım Raporu'nda Bulunabilir Bildirildiği yer:
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 4xx1 Evet Evet Evet
NOT_FOUND (Street View Static, Coğrafi Konum ve Yollar API'leri),
ZERO_RESULTS (Street View Static API)
404 4xx 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
İSTEK REDDEDİLDİ 200/400/403 4xx1 Evet Hayır Hayır
OVER_DAILY_LIMIT,
OVER_QUERY_LIMIT,
SOURCE_EXHAUSTED,
DailyLimitExceeded,
rateLimitExceeded,
userRateLimitExceeded
200/403,
429
4xx1 Evet Hayır Hayır
UNKNOWN_ERROR 200/500,
503
5xx1 Evet Evet Hayır
1 Google Haritalar Platformu API'leri, hata kodu raporlamasının tutarlılığını iyileştirmek amacıyla: 1) Maps API durumları için 2xx HTTP yanıt kodu sınıfından 4xx'e 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 değerine: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, kod userRateLimitExceeded2xxrateLimitExceeded5xxUNKNOWN_ERROR Geçiş süresi boyunca 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'ndeki 4xx ve/veya 5xx artışlarını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şim kurduğuna dair analizler sunar. Bu analizler, haritadaki görüntülemeler veya bir ÖY ile etkileşimler gibi temel etkileşim metriklerini içerir. Reklam ve pazarlama için popüler konumları ortaya çıkarmak veya kullanıcı deneyiminizi optimize etmek amacıyla bu bilgileri analiz edebilirsiniz.

İşletme analizleri raporlama özellikleri aşağıdakileri içerir:

  • İşletme analizlerindeki önemli trendleri bir bakışta görmek için üst düzey işletme analizleri 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
  • Favori iş analizi aracınızda iş analizi verilerini analiz edebilmek için metrikleri CSV'ye aktarma

Mevcut etkileşim metrikleri şunlardır:

  • Harita Görünümleri: Kaydırma, yakınlaştırma veya yatırma hareketlerinden kaynaklanan harita görünümlerini takip edebilirsiniz. Harita Görünümleri haftalık olarak posta koduna göre hesaplanır (Pasifik saatiyle Pazardan Cumartesiye). Yeni veriler haftalık olarak, gözlem döneminden sonraki ilk çarşamba günü yayınlanır.

Kullanıcılar, Cloud Console'daki Metrikler Sayfası'nda işletmenizle ilgili önemli bilgileri görüntüleyebilir. Harita Görünümleri şu anda yalnızca test amacıyla bazı Maps JS API geliştiricileri tarafından kullanılabilmektedir.

Filtre ve Gruplama Ölçütü özellikleriyle doğrudan konsolda etkileşim metriklerini analiz ederek metrikleri daha ayrıntılı bir şekilde inceleyebilirsiniz. Örneğin, harita görüntülemelerinin yalnızca o bölgedeki posta kodları için nasıl bir eğilim gösterdiğini öğrenmek için belirli bir bölgeye göre filtreleme yapmayı seçebilirsiniz. Diğer yandan, belirli bir bölge içindeki etkileşimleri toplamak için belirli bir bölgeye göre gruplama yapmak isteyebilirsiniz.

Kullanıcılar, tercih ettikleri iş analizi aracında daha ayrıntılı analiz yapmak için veri kümesinin tamamını veya filtrelenmiş görünümü CSV'ye aktarabilir. Tek seferde 90 güne kadar indirme yapabilirsiniz. 60.000'den fazla hücre indirebilirsiniz. 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ştirilmiştir 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ğerlerden gelen katkılar azalabilir.

Haritalar Analizi iznini kullanarak Google Cloud Console'da Cloud projeniz için işletme analizlerine erişimi kontrol edebilirsiniz. Proje Sahipleri varsayılan olarak bu izne sahiptir ve gerektiğinde diğer kullanıcılara 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ını inceleyin.

Locator Plus

Locator Plus kullanıcıları için analiz kontrol paneli, verilerinizi analiz etmenize ve elde etmenize yardımcı olur. Böylece, alışveriş yapan kullanıcıların mağaza bulma aracınızla ne kadar iyi etkileşim kurduğunu net bir şekilde görebilirsiniz. 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 haftadan haftaya performansınızı ö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 sunar.

Karşılaştırma raporu, verilerinizi, verilerini paylaşan diğer şirketlere ait toplu sektör verileriyle karşılaştırmanıza olanak tanır. Karşılaştırma değerli bir bağlam sunarak anlamlı hedefler belirlemenize, sektör trendleriyle ilgili bilgi edinmenize ve rakiplerinize kıyasla nasıl performans gösterdiğinizi öğrenmenize yardımcı olur.

Karşılaştırma verilerini görmek için etkileşim verileriniz anonim olarak Google karşılaştırmalarına dahil edilir. Etkileşim verilerinizin hem görüntülenmesini hem de karşılaştırma raporlarına anonim olarak dahil edilmesini devre dışı bırakmak için destek kaydı oluşturun. Destek kaydı genellikle 3 gün içinde çözüme kavuşturulur.