Google Haritalar Platformu'ndaki raporlama, Google Cloud Console'da temel API kullanımı, kota ve faturalandırma bilgilerini içeren önceden tanımlanmış bir dizi görsel rapor sağlar. Yaptığınız API çağrılarının sayısını, API kullanım kotalarına ne kadar yaklaştığınızı belirlemek ve zaman içindeki faturalandırma kullanımınızı izlemek için bu raporları kullanın.
Rapor türleri şunlardır:
- Kullanım raporları: Projenizin, projenizle ilişkili kimlik bilgilerini kullanarak Google Haritalar Platformu API'lerine gönderdiği istek sayısını raporlar.
- Kota raporları: Kota kullanımını, dakika başına istek sayısına göre gruplandırılabilen grafiklerde raporlar. Seçilen API'ler için geçerli kota sınırları, kota kullanımı grafiklerinin altındaki tablolarda gösterilir.
- Faturalandırma raporları: Zaman içindeki maliyetleri yığılmış çizgi grafik olarak raporlar. Uygulanan kullanıma özel krediler dahil olmak üzere mevcut ayın kota kullanımını ve mevcut ayın tamamı için tahmini toplam maliyeti görüntüleyin.
- Etkileşim raporları: Kullanıcıların harita uygulamalarınızla nasıl etkileşimde bulunduğuyla ilgili işletme analizleri sağlar.
Bir isteğin Kullanım, Kota ve/veya Faturalandırma raporlarında görünüp görünmeyeceğini tanımlayan yanıt durumlarının ve yanıt kodlarının tam listesi için Yanıt durumu ve raporlar başlıklı makaleyi inceleyin.
Cloud Console'u kullanarak Google Haritalar Platformu kullanımı, kota ve faturalandırma raporlarını görüntüleyin.
Kullanım raporları
Kullanım, projenizle ilişkili kimlik bilgilerini kullanarak projenizin Google Haritalar Platformu API'lerine gönderdiği isteklerin sayısına bağlıdır. İstekler; başarılı istekler, sunucu hatalarına neden olan istekler ve istemci hatalarına neden olan istekleri içerir. Kimlik bilgileri arasında API anahtarları ve istemci kimlikleri (Premium Plan ve taşınan Premium Plan projeleri için) bulunur. Ayrıntılar için Premium Plan'a Genel Bakış'a ve istemci kimliği kullanımıyla ilgili bilgilere bakın.
Kullanım metrikleri tablolarda (İstekler, Hatalar ve Gecikme) ve grafiklerde (Trafik, Hatalar ve Gecikme) gösterilir. İzleme amacıyla:
Tüm API'ler: Tüm API'lerin kullanım metriklerini aşağıdaki yöntemlerle filtreleyebilir ve gruplandırabilirsiniz:
- Döneme ve API'ye göre filtreleyin.
- Yanıt koduna, API'ye ve kimlik bilgisine göre gruplandırılmış trafik, hata ve gecikmeyi görün.
Belirli bir API: Belirli bir API'nin kullanım metriklerini aşağıdaki yöntemlerle filtreleyebilir ve gruplandırabilirsiniz:
- Dönem, API sürümü, kimlik bilgileri ve yöntemlere göre filtreleme yapın.
- Yanıt koduna, API yöntemine ve sürümüne, kimlik bilgisine göre gruplandırılmış trafiği, hatayı ve gecikmeyi görün.
API'ler ve Hizmetler Kontrol Paneli sayfası
API'ler ve Hizmetler Kontrol Paneli, projenizde etkinleştirilen tüm API'lerin (Google Haritalar Platformu API'lerinin yanı sıra diğer API'ler ve hizmetler) kullanım metriklerine genel bir bakış sunar.
Kontrol paneli sayfasında üç grafik ve bir tablo bulunur. Grafiklerde ve tablolarda gösterilen kullanımı, 1 saatten son 30 güne kadar bir dönem seçerek filtreleyebilirsiniz.
Trafik grafiği, API başına dakika başına sorgu (QPM) olarak kullanımı gösterir.
Hatalar grafiği, API başına hatayla sonuçlanan isteklerin yüzdesini gösterir.
Gecikme grafiği, API başına isteklerin ortalama gecikmesini gösterir.
Grafiklerin altında, etkin API'ler ve hizmetler tabloda listelenir. İstekler, isteklerin sayısıdır (seçilen dönem için). Hatalar, bu isteklerin hatayla sonuçlanan sayısıdır. Gecikme (orta gecikme ve yüzdelik dilim), bu isteklerin gecikmesidir.
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 seçin ve ardından API'ler ve Hizmetler'i seçin.
Daha fazla bilgi için API Kullanımınızı İzleme başlıklı makaleyi inceleyin.
Google Haritalar'a Genel Bakış sayfası
Google Haritalar Genel Bakış sayfasında, etkin API'leri ve son 30 güne ait kullanım isteklerini listeleyen bir tablo bulunur. API'ye göre istekler de grafik şeklinde gösterilir. Faturalandırma grafiği, mevcut faturanızı ve son 3 aya ait toplam kullanımınızı gösterir.
Google Haritalar Platformu'na Genel Bakış sayfasına erişmek için:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Soldaki menüde Genel bakış'ı seçin.
Google Haritalar Platformu API'leri ve Hizmetleri sayfası
Google Haritalar API'ler ve Hizmetler sayfasında, projenizde kullanabileceğiniz API'leri, SDK'ları ve diğer hizmetleri gösteren bir karo ızgarası bulunur. Her kartta Etkinleştir veya Devre dışı bırak'ı seçerek ilgili hizmeti etkinleştirebilir ya da devre dışı bırakabilir, ayrıca etkin API'ler için kimlik bilgileri, metrikler ve kullanıcı kılavuzlarına erişebilirsiniz. Etkin veya devre dışı bırakılmış hizmetleri ve diğer hizmet kategorilerini görüntülemek için sayfa filtrelerini de kullanabilirsiniz.
Google Haritalar Platformu API'ler ve Hizmetler sayfasına erişmek için:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Sol menüden API'ler ve Hizmetler'i seçin.
Google Haritalar Metrikleri sayfası
Google Haritalar Metrikler sayfasında üç grafik gösterilir: Trafik, Hatalar ve Ortalama Gecikme. Grafiklerdeki kullanım verileri yanıt kodu sınıfına, API'ye, API yöntemine, kimlik bilgisine, platforma ve alana göre gruplandırılabilir.
Metrikler sayfasındaki grafiklerin altında, seçtiğiniz API'lerin isteklerini, hatalarını ve gecikmesini gösteren bir API tablosu bulunur.
Üstteki API açılır menüsünü ve sağ bölmede bulunan gruplandırma ve filtreleme seçeneklerini kullanarak belirli veya birden fazla API, Kimlik Bilgileri, Yanıt Kodu sınıfları, Platform türü ve/veya Alan seçerek görüntülenen kullanım metriklerini gruplandırabilir ve filtreleyebilirsiniz. Gösterilen kullanım metrikleri için bir dönem (bir saatten son 30 güne kadar) ve ayrıntı düzeyi (saniye veya gün başına) de seçebilirsiniz.
Aşağıdaki resimlerde, Gruplandırılma ölçütü açılır listesinde Platform ve Alan'a göre gruplandırma seçildiğinde tek bir API için Platform ve Alan filtreleri gösterilmektedir:
Google Haritalar Platformu API Metrikleri sayfasına erişmek için:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Sol menüden Metrikler'i seçin.
Kimlik bilgisi raporlaması
Metrikleri, API'yi yüklemek için kullanılan kimlik bilgisine göre filtreleyebilir ve gruplandırabilirsiniz.
Kimlik bilgisi biçimi | Anlamı |
---|---|
Anahtar adı Örneğin, "Mobil uygulama anahtarı" |
?key=... kullanılarak API'yi yüklemek için bir API anahtarı kullanıldı: Anahtar adlarını Haritalar Platformu Console'daki Anahtarlar ve Kimlik Bilgileri bölümünde bulabilirsiniz. |
Proje Numarası Örneğin, 123456 proje numaranız olduğunda "project_number:123456". |
Bu kimlik bilgisini gördüğünüzde iki olasılık vardır:
|
Yanıt kodu grafikleri
Yanıt koduna göre trafik ve Yanıt koduna göre hata grafikleri, kullanımı HTTP yanıt kodu sınıfına göre böler. Bu tabloda, Google Haritalar Platformu API yanıt durumu ile HTTP yanıt kodu sınıfı arasındaki eşleme gösterilmektedir:
Maps API durumu | HTTP yanıt kodu sınıfı - Kullanım raporu (2xx, 3xx, 4xx, 5xx) |
Notlar |
---|---|---|
Tamam | 2xx | Başarılı yanıt. Bu, faturalandırılabilir bir istektir ve kota tüketir. |
Tamam | 3xx | Başarılı yanıt. Bu, faturalandırılabilir bir istektir ve kotayı tüketir. Örneğin, Yer Fotoğrafı başarılı istekleri, başvurulan resme 302 yönlendirme döndürür. |
DATA_NOT_AVAILABLE | 4xx(1) | Giriş konumları için kullanılabilecek veri olmadığını belirten başarılı yanıt. Bu, faturalandırılabilir bir istektir ve kotayı tüketir. |
ZERO_RESULTS | 4xx(1) | Başarılı yanıt hiçbir sonuç döndürmedi. Bu, faturalandırılabilir bir istektir ve kota tüketir. |
NOT_FOUND | 4xx(1) | Directions API için bu mesaj, istekteki başlangıç, varış veya yol üstü noktalarında belirtilen konumlardan en az birinin coğrafi kodlanamadığı anlamına gelir. Places API için bu mesaj, referans verilen konumun (place_id) Places veritabanında bulunamadığını gösterir. Bu, faturalandırılabilir bir istektir ve kota tüketir. |
INVALID_REQUEST (geçersiz parametre değeri), MAX_WAYPOINTS_EXCEEDED, MAX_ROUTE_LENGTH_EXCEEDED ve diğerleri. |
4xx | Geçersiz parametre değerinden kaynaklanan hata. Daha fazla bilgi için API yanıtını kontrol edin. Bu, faturalandırılabilir bir istektir ve kota tüketir. |
REQUEST_DENIED | 4xx | Kimlik doğrulama hatası, erişim hatası ve diğer nedenlerden kaynaklanan istemci hatası. Daha fazla bilgi için API yanıtını kontrol edin. |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, dailyLimitExceeded, userRateLimitExceeded |
4xx | İzin verilen zaman aralığı başına çok fazla istek gönderilmesinden kaynaklanan istemci hatası. İsteği daha sonra tekrar deneyin. Daha fazla bilgi için API yanıtını kontrol edin. |
INVALID_REQUEST (geçersiz veya eksik parametre, istek ayrıştırma veya doğrulama hatası) | 4xx | Geçersiz istek nedeniyle istemci hatası. Daha fazla bilgi için API yanıtını kontrol edin. |
NOT_FOUND (404) | 4xx | Coğrafi Konum API için bu mesaj, girişlerin konum tahmini oluşturmak için yeterli olmadığını gösterir. Roads API için bu mesaj, girişlerin yollara makul bir şekilde bağlanamadığını gösterir. Bu, faturalandırılabilir bir istektir ve kotayı tüketir. |
UNKNOWN_ERROR | 5xx | İsteğin devam edilemediğini belirten sunucu hatası: dahili hata, hizmet aşırı yüklü, kullanılamıyor, zaman aşımı ve diğerleri. |
1
Hata kodu raporlamasının tutarlılığını iyileştirmek için Google Maps Platform API'leri taşınıyor:
1) DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - durum için HTTP yanıt kodu sınıfı 2xx 'den 4xx 'e,
2) REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded için HTTP yanıt kodu sınıfı 2xx 'den 4xx 'e,
3) UNKNOWN_ERROR için HTTP yanıt kodu sınıfı 2xx 'den 5xx 'ye.
Geçiş döneminde her iki yanıt kodunu da görebilirsiniz. Haritalar API yanıtlarında döndürülen yanıt kodları değişmeyecek.
Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx değerinin artmasının bu taşımayla ilgili olduğunu onaylayın (Google Haritalar Platformu için Google Cloud İzleme'yi kullanma hakkında daha fazla bilgi edinin).
|
Durum kodları ve hata mesajları hakkında daha fazla bilgi için ilgilendiğiniz API'nin yanıt dokümanlarına (ör. Coğrafi Kodlama Yanıtları veya Yol Tarifi Yanıtları) bakın.
Google Haritalar Platformu çözümleri parametresi
Google Haritalar Platformu, hızlı bir şekilde çalışmaya başlamanıza yardımcı olmak için birçok türde örnek kod sağlar. Örneğin, Cloud Console'da Hızlı Oluşturucu'yu kullanabilir, sektör çözümlerinin uygulama kılavuzlarını takip edebilir ve codelabs yararlanabilirsiniz.
Google, kullanımları ve çözümlerimizi iyileştirmenin yollarını anlamak için örnek kod kullanımı hakkında bilgi toplamak amacıyla API çağrılarına solution_channel
sorgu parametresini ekler:
solution_channel
sorgu parametresi, çözüm örnek koduna varsayılan olarak dahildir.- Sorgu parametresi, gelecekteki iterasyonlarda çözüm kalitesini iyileştirmek için Google'a çözüm benimsemeyle ilgili analizler döndürür.
solution_channel
sorgu parametresini ve değerini örnek koddan silerek devre dışı bırakabilirsiniz.- Parametreyi tutma zorunluluğu yoktur. Sorgu parametresinin kaldırılması performansı etkilemez.
- Sorgu parametresi yalnızca örnek kod kullanımı raporlaması için kullanılır.
- Sorgu parametresi, API'ye özgü analizlerden ve raporlardan ayrıdır. Yani parametrenin çözüm örnek kodundan kaldırılması, dahili Maps JavaScript API raporlamasını devre dışı bırakmaz.
Kota raporları
Kotalar, projenizin Google Haritalar Platformu API'lerine gönderebileceği istek sayısına sınırlar getirir. İstekler üç şekilde sınırlanabilir: gün başına, dakika başına ve kullanıcı başına dakika başına. Yalnızca başarılı istekler ve sunucu hatalarına neden olan istekler kotaya dahil edilir. Kimlik doğrulama işleminin başarısız olduğu istekler kotaya dahil edilmez.
Kota kullanımı, Cloud Console'daki Kotalar sayfasında grafiklerle gösterilir ve dakika başına istek sayısına göre gruplandırılabilir. Seçilen API'ler için geçerli kota sınırları, kota kullanımı grafiklerinin altındaki tablolarda gösterilir.
Herhangi bir GMP API ürünü için dakika başına kota değerinizi öğrenmek üzere bu hesaplayıcıyı kullanın.
Google Haritalar kotaları sayfası
Google Haritalar Kotalar sayfasında, seçtiğiniz API'nin kota sınırları ve kota tüketimi gösterilir.
Google Cloud Console'daki kota kullanımı grafiği, API anahtarlarınız ve istemci kimliklerinizin toplam trafiğini gösterir. İstemci kimliği trafiği, Cloud Console'daki Metrikler grafiğinde de gösterilir.
Sayfada yalnızca kota tüketen istekler gösterilir: başarılı istekler (OK
, ZERO_RESULTS
, DATA_NOT_AVAILABLE
) ve sunucu hatalarına neden olan istekler (NOT_FOUND
, INVALID_REQUEST/INVALID_VALUE
(geçersiz parametre değeri), UNKNOWN_ERROR
).
Müşteri hatalarına neden olan istekler (kimlik doğrulama, yetkilendirme ve geçersiz bağımsız değişken hataları (REQUEST_DENIED
, OVER_QUERY_LIMIT
, INVALID_REQUEST
(geçersiz parametre, istek ayrıştırma hatası))) kotayı tüketmez ve gösterilmez.
Kota birimi, Google Haritalar Platformu API'lerinin çoğu (Maps Static API, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API ve Elevation API) için bir istektir ancak bazı istisnalar vardır:
- Mesafe Matrisi API'sinde kota birimi, başlangıç-hedef çifti olan bir öğedir.
- Maps JavaScript API için kota birimi, harita yüklemesidir.
- Android için Haritalar SDK'sı ve iOS için Haritalar SDK'sında kota birimi, Street View isteği veya Panorama yüklemesidir. Harita yüklemeleri ücretsizdir ve kotayı tüketmez.
Google Haritalar Platformu kotaları sayfasına erişmek için:
- Cloud Console'da Google Haritalar Platformu sayfasını açın:
- Sol menüden Kotalar'ı seçin.
- API açılır listesinden bir API seçin.
Kota birimleri
Bu tabloda, Google Haritalar Platformu API'leri için kota birimi gösterilmektedir.
Google Haritalar Platformu API'si | Kota birimi |
---|---|
Maps | |
Android için Haritalar SDK'sı | 1 panorama |
iOS için Haritalar SDK'sı | 1 panorama |
Map Tiles API | 1 istek |
Haritalar Kuş Bakışı API'si | 1 istek |
Maps Static API | 1 istek |
Maps JavaScript API | 1 Harita Yükleme |
Street View Static API | 1 istek |
Maps Embed API | 1 Harita Yükleme |
Rotalar | |
Routes API (Compute Routes) | 1 istek |
Routes API (Compute Route Matrix) | 1 Öğe (başlangıç-hedef çifti) |
Directions API | 1 istek |
Distance Matrix API | 1 Öğe (başlangıç-hedef çifti) |
Roads API | 1 istek |
Route Optimization API | 1 istek |
Android için Navigasyon SDK'sı | 1 hedef |
iOS için Navigasyon SDK'sı | 1 hedef |
Yerler | |
Places API | 1 istek |
Address Validation API | 1 istek |
Geocoding API | 1 istek |
Geolocation API | 1 istek |
Time Zone API | 1 istek |
Ortam | |
Air Quality API (CurrentConditions ve HeatmapTile) | 1 istek |
Air Quality API (Geçmiş) | 1 sayfa |
Pollen API | 1 istek |
Solar API | 1 istek |
Fatura raporları
Faturalandırma raporunuzu görüntüleme
Google Haritalar Platformu ürünlerini kullanımınıza ilişkin faturalandırma raporları Google Cloud Console'da mevcuttur. Daha fazla bilgi için Faturalandırma başlıklı makaleyi inceleyin.
Faturalandırma raporlarına erişmek için:
- Cloud Console'da Proje seçici sayfasını açın:
- Proje seçin.
- Menü düğmesini seçin 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 sol menüden Raporlar'ı seçin.
Faturalandırma raporu grafiğini okuma
Faturalandırma raporları, maliyeti zaman içinde yığılmış çizgi grafik olarak gösterir. Varsayılan görünümde, geçerli ayın günlük kullanıma özel maliyetleri (tüm ürünler için) uygulanan kullanıma özel krediler dahil olmak üzere projeye göre gruplandırılmış olarak ve geçerli ayın tamamı için tahmini toplam maliyet gösterilir. Grafikteki her satır (ve özet tablosundaki her satır), maliyete göre en büyükten en küçüğe doğru sıralanan projeye karşılık gelir. Faturalandırma raporu grafiğini yorumlama hakkında daha fazla bilgi edinin.
İpucu: SKU başına kullanım ve maliyeti analiz edin
Kullandıkça öde fiyatlandırma modelinin ayrıntılarını ve uygulamanızı nasıl etkilediğini daha doğru anlamak için SKU'ya göre kullanım ve maliyetinize bakın.
Satır öğelerini SKU'ya göre görüntülemek için rapor görünümünü değiştirmek üzere:
- Grafiğin sağındaki panelde Gruplandır filtresini genişletin.
- SKU'yu seçin.
Kullanılabilen diğer faturalandırma raporu filtreleri arasında Zaman aralığı, Projeler, Ürünler, SKU'lar ve API isteklerinin sunulduğu yere göre filtreleme yapmanıza olanak tanıyan Konumlar yer alır.
Ürüne ek olarak kullanım kaynağınızı kategorize etmek için faturalandırma raporlarını listelenen değerlerden birine göre gruplandırın. Google Maps Platform API'leriyle ilgili üç anahtar şunlardır: goog-maps-api-key-suffix (API anahtarının son dört karakteri), goog-maps-platform-type (platform: Android, iOS, JavaScript veya web hizmeti) ve goog-maps-channel (API sorgusundan alınan bir sayısal kanal değeri). Filtreleme ve gruplandırma hakkında daha fazla bilgi
Sağ paneldeki Kredileri maliyete dahil et onay kutusunu temizleyerek grafik görünümünü, kullanıma özel kredileri hariç tutacak şekilde değiştirebilirsiniz.
Tüketimi izleme ve kısıtlama
Bütçenizi planlamanıza ve maliyetleri kontrol etmenize yardımcı olması için aşağıdakileri yapabilirsiniz:
- Harcamalarınızın belirli bir tutara doğru nasıl arttığını izlemek için bütçe uyarısı ayarlayın. Bütçe ayarlamak API kullanımına sınır getirmez. Yalnızca harcama tutarınız belirtilen tutara yaklaştığında sizi uyarır.
Faturalandırılabilir API'lerin kullanım maliyetinizi yönetmek için günlük API kullanım sınırınızı belirleyin. Günlük istek sayısı için sınırlar belirleyerek harcamanızı sınırlandırabilirsiniz. Harcamak istediğiniz tutara bağlı olarak günlük sınırınızı belirlemek için basit bir denklem kullanın. Örneğin: (Aylık harcama /her SKU başına fiyat)/30 = günlük istek sınırı (bir API için).
Kanal başına kullanım izleme
Kullanımınızı sayısal kanallar aracılığıyla izlemek için API isteklerinize "channel" parametresini eklemeniz gerekir. Yalnızca 0 ile 999 arasında sayılar kabul edilir. Aşağıda birkaç örnek verilmiştir:
- Geocoding Web Service API
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
- Maps JavaScript API
<script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap" async defer></script>
Kanal kullanımınızı doğrudan Faturalandırma Raporunuzdan izleyin. Kanallar, Etiketler bölümünde goog-maps-channel anahtarı olarak gösterilir.
Faturalandırma raporunuzu SKU'ya ve kanala göre filtrelemek için:
- Gruplandırma ölçütü SKU filtresini kullanın.
- Etiketler oku seçin.
- 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 kanalın oluşturduğu maliyeti görmek için etiket anahtarına goog-maps-channel göre gruplandırın.
Kanal kullanım verilerini isteklerinize uyguladıktan sonra verilerin faturalandırma raporunuza yansıtılması 24 saati bulabilir.
Faturalandırma verilerinizi BigQuery ile dışa aktarma
Faturalandırma verilerinizi BigQuery'ye de aktarabilirsiniz.
BigQuery dışa aktarma özelliği, ayrıntılı Cloud Billing verilerini (kullanım ve maliyet tahmini verileri gibi) belirttiğiniz bir BigQuery veri kümesine gün boyunca otomatik olarak aktarmanıza olanak tanır. Ardından, ayrıntılı analiz için BigQuery'den faturalandırma verilerinize erişebilirsiniz. Bu sayede, Google Haritalar Platformu kullanımınızın kaynağını daha ayrıntılı bir şekilde anlayabilirsiniz.
BigQuery Export'u kullanmaya ve verileri sorgulamaya başlamak istiyorsanız aşağıdaki örnek sorguyu deneyebilirsiniz. Bu sorguyu çalıştırmadan önce:
- Hesabınızda faturalandırmayı ve BigQuery faturalandırma dışa aktarma özelliğini etkinleştirin.
- Tablo biçimi PROJECT_ID.DATASET_NAME.gcp_billing_exportv1BILLING_ACCOUNT_ID şeklindedir. Burada:
- PROJECT_ID, gerçek proje kimliğinizdir (ör. "projem-123456").
- DATASET_NAME, oluşturduğunuz veri kümesinin adıdır (ör. "SampleDataSet").
- BILLING_ACCOUNT_ID, faturalandırma hesabı kimliğinizin referansı olup "gcp_billing_exportv1" ön ekiyle başlar ve kısa çizgiler (-) alt çizgilerle (_) değiştirilir.
Örneğin, 123456-7890AB-CDEF01 faturalandırma hesabı kimliği
gcp_billing_export_v1_123456_789AB_CDEF01
olur.
#standardSQL
SELECT Date(usage_start_time, "America/Los_Angeles") AS billing_day,
invoice.month AS invoice_month,
service.description AS service,
sku.description AS sku,
(
SELECT l.value
FROM Unnest(labels) AS l
WHERE l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
Round(Sum(usage.amount), 2) AS usage_amount,
usage.unit AS usage_unit,
Round(Sum(cost), 2) AS cost,
cost_type,
currency
FROM PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID
WHERE invoice.month = '202002' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
invoice_month,
service,
sku,
goog_maps_channel,
usage_unit,
cost_type,
currency
ORDER BY billing_day,
service,
sku
İ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
- 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, Haritalar API durumu, Haritalar API yanıtlarında döndürülen HTTP yanıt kodu ve Kullanım Raporu'ndaki HTTP yanıt kodu sınıfı arasındaki eşleme gösterilmektedir. Ayrıca, ilgili isteğin Kullanım, Kota ve Faturalandırma raporlarında görünüp görünmediği de belirtilmektedir.
Google Haritalar Platformu Metrikleri'ndeki Kullanım Raporu HTTP response code class
ayrıntı düzeyindedir. Daha yüksek düzeyde ayrıntıya ihtiyacınız varsa Google Haritalar Platformu Kullanım İzleme bölümündeki Yanıt durum kodları'na bakın.
Maps API yanıtlarında kullanılabilen yanıt kodları | Kullanım raporunda kullanılabilir. | Bildirilen | |||
---|---|---|---|---|---|
Maps API durumu | HTTP yanıt kodu | HTTP yanıt kodu sınıfı | Kullanım | Kota | Faturalandırma |
Tamam | 200, 204, 302 |
2xx, 3xx |
Evet | Evet | Evet |
DATA_NOT_AVAILABLE, NOT_FOUND, ZERO_RESULTS |
200, 404 |
4xx1 | Evet | Evet | Evet |
INVALID_REQUEST (geçersiz parametre değeri), MAX_ROUTE_LENGTH_EXCEEDED, MAX_WAYPOINTS_EXCEEDED, vb. |
200, 400 |
4xx | Evet | Evet | Evet |
INVALID_REQUEST (geçersiz/eksik parametre, istek ayrıştırma hatası) | 200, 400 |
4xx | Evet | Hayır | Hayır |
REQUEST_DENIED | 200, 400, 403 |
4xx1 | Evet | Hayır | Hayır |
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded |
200, 403, 429 |
4xx1 | Evet | Hayır | Hayır |
UNKNOWN_ERROR | 200, 500, 503 |
5xx1 | Evet | Evet | Hayır |
1
Hata kodu raporlamasının tutarlılığını iyileştirmek için Google Maps Platform API'leri taşınıyor:
1) DATA_NOT_AVAILABLE , NOT_FOUND ,
ZERO_RESULTS - durum için HTTP yanıt kodu sınıfı 2xx 'den 4xx 'e,
2) REQUEST_DENIED , OVER_DAILY_LIMIT ,
OVER_QUERY_LIMIT , dailyLimitExceeded ,
rateLimitExceeded , userRateLimitExceeded için HTTP yanıt kodu sınıfı 2xx 'den 4xx 'e,
3) UNKNOWN_ERROR için HTTP yanıt kodu sınıfı 2xx 'den 5xx 'ye.
Geçiş döneminde her iki yanıt kodunu da görebilirsiniz. Haritalar API yanıtlarında döndürülen yanıt kodları değişmeyecek.
Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'nde 4xx ve/veya 5xx değerinin artmasının bu taşımayla ilgili olduğunu onaylayın (Google Haritalar Platformu için Google Cloud İzleme'yi kullanma hakkında daha fazla bilgi edinin).
|
Etkileşim raporları
İşletme Analizleri
Google Haritalar Platformu, kullanıcıların haritalarınızla nasıl etkileşimde bulunduğuna dair analizler sunar. Bu analizler, haritadaki görüntülemeler veya ÖY ile etkileşimler gibi önemli etkileşim metriklerini içerir. Reklamcılık ve pazarlama için popüler konumları keşfetmek veya kullanıcı deneyiminizi optimize etmek amacıyla bu analizleri inceleyebilirsiniz.
İşletme bilgileri raporlama özellikleri şunlardır:
- İşletme analizlerindeki önemli trendleri bir bakışta görmek için üst düzey bir işletme analizi anlık görüntüsünü görüntüleme
- Metrikleri daha ayrıntılı bir şekilde anlamak için konsolda belirli bir metriği analiz etmek üzere ayrıntılı inceleme
- Metrikleri CSV'ye aktararak işletme analizleri verilerini favori işletme analiz aracınızda analiz edebilirsiniz.
Kullanılabilen etkileşim metrikleri şunlardır:
- Harita Görüntüleme Sayısı: Haritayı kaydırarak, yakınlaştırarak veya eğdirerek yapılan görüntülemelerin sayısını izler. Harita görüntülemeleri, posta koduna göre haftalık olarak (Pasifik saatine göre Pazar-Cumartesi) hesaplanır. Yeni veriler, gözlem dönemini takip eden ilk Çarşamba günü haftalık olarak yayınlanır.
Proje sahipleri ve Haritalar Analytics Görüntüleyici rolüne sahip kullanıcılar, Cloud Console'daki Metrikler Sayfası'nda işletme analizlerini görüntüleyebilir. Projede Maps JavaScript API etkin olmalıdır.
Metrikleri daha ayrıntılı şekilde incelemek için filtreleme ve gruplandırma özelliklerini kullanarak etkileşim metriklerini doğrudan konsolda analiz edebilirsiniz. Örneğin, harita görüntülemelerinin yalnızca belirli bir bölgedeki posta kodları için nasıl bir trend gösterdiğini öğrenmek üzere belirli bir bölgeye göre filtreleme yapmayı seçebilirsiniz. Öte yandan, belirli bir bölgedeki etkileşimleri toplamak için belirli bir bölgeye göre gruplandırma yapmak isteyebilirsiniz.
Kullanıcılar, veri kümesinin tamamını veya filtrelenmiş bir görünümü CSV olarak dışa aktararak favori iş analiz aracında daha ayrıntılı analizler yapabilir. Tek seferde en fazla 90 gün indirebilirsiniz. 60.000'den fazla hücre içeren indirmeler ise kısaltılır. Harita görünümü verilerinin CSV'ye aktarılması, seçilen zaman aralığına bağlı olarak birkaç dakika sürebilir.
İşletme analizleri metrikleri anonimleştirilir ve bu nedenle yalnızca haritalarınızla etkileşimdeki genel trendleri yansıtır. Düşük sayılar sıfıra yuvarlanabilir ve aykırı değerlerin katkıları azaltılabilir.
Haritalar Analytics iznini kullanarak Google Cloud Console'da Cloud projenizin işletme analizlerine erişimi kontrol edebilirsiniz. Proje sahiplerine varsayılan olarak bu izin verilir ve gerektiğinde diğer kullanıcılara erişim izni verebilirler.
İşletme Analizleri, kullanım maliyetlerinizi tahmin etmek için kullanılmamalıdır. Daha fazla kullanım bilgisi için lütfen kullanım raporlarına göz atın.