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.
- Etkileş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:
- Cloud Console'da Proje seçici sayfasını açın:
- 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:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Soldaki 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'ler, SDK'lar ve diğer hizmetleri temsil eden bir karolar ızgarası bulunur. Her parçada Etkinleştir'i veya Devre dışı bırak'ı seçerek hizmeti etkinleştirebilir ya da devre dışı bırakabilirsiniz. Ayrıca kimlik bilgisi bilgilerine, metrics ve etkinleştirilmiş API'lerle ilgili kullanıcı rehberlerine erişebilirsiniz. Etkin veya devre dışı olan 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:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Soldaki menüden API'ler ve Hizmetler'i seçin.
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:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- 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:
|
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)userRateLimitExceeded 5xx 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ş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:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Soldaki menüde Kotalar'ı seçin.
- 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:
- Cloud Console'da Proje seçici sayfasını açın:
- Proje seçin.
- Menü düğmesini ve ardından Faturalandırma'yı seçin.
- 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.
- 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:
- Grafiğin sağındaki panelde Gruplandırma ölçütü filtresini genişletin.
- 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
- SKU filtresini Gruplandırma ölçütü olarak kullanın.
- Etiketler düzeltme işaretini seçin.
- Key (Anahtar) açılır menüsünü ve goog-maps-channel'ı seçin.
- 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 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)userRateLimitExceeded 5xx 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ş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.