Google Haritalar Platformu Raporlaması

Google Haritalar Platformu'ndaki raporlama, Google Cloud Console'daki temel API kullanımı, kota ve fatura bilgilerine dair önceden tanımlanmış bir dizi görsel rapor sağlar. Bu raporları kullanarak yaptığınız API çağrılarının sayısını, API kullanım kotalarına ulaşmaya ne kadar yakın olduğunuzu belirleyebilir ve zaman içindeki faturalandırma kullanımınızı izleyebilirsiniz.

Rapor türleri şunlardır:

  • Kullanım raporları: Projenizle ilişkili kimlik bilgilerini kullanarak Google Haritalar Platformu API'lerine projenizin yaptığı istek sayısını bildirir.
  • Kota raporları: Dakika başına istek bazında gruplandırılabilen grafiklerde kota kullanımını raporlar. Seçili API'ler için geçerli kota sınırları, kota kullanım grafiklerinin altındaki tablolarda gösterilir.
  • Faturalandırma raporları: Maliyetleri zaman içinde yığın çizgi grafik olarak raporlar. Uygulanan kullanıma özel krediler dahil 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ünmediğ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 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 arasında API anahtarları ve istemci kimlikleri (Premium Plan ve taşınan Premium Plan projeleri için) bulunur. Ayrıntılar için Premium Plana Genel Bakış bölümünü ve istemci kimliği kullanmayla ilgili bilgileri inceleyin.

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'ler: Tüm API'ler için kullanım metriklerini aşağıdaki yöntemlerle filtreleyebilir ve gruplandırabilirsiniz:

    • Zaman aralığına ve API'ye göre filtreleyin.
    • Trafik, hata ve gecikmeyi yanıt kodu, API ve kimlik bilgilerine göre gruplandırılmış halde görün.
  • Belirli bir API: Belirli bir API'nin kullanım metriklerini şu şekillerde filtreleyebilir ve gruplandırabilirsiniz:

    • Zaman aralığına, API sürümlerine, kimlik bilgilerine ve yöntemlere göre filtreleyin.
    • Trafik, hata ve gecikmeyi yanıt kodu, API yöntemi, sürümü ve kimlik bilgilerine göre gruplandırılmış olarak 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'leri, diğer API'ler ve hizmetler) kullanım metriklerine genel bir bakış sunar.

  • Kontrol paneli sayfasında üç grafik ve bir tablo bulunur. 1 saat ile son 30 gün arasında bir zaman aralığı seçerek grafiklerde ve tablolarda gösterilen kullanımı filtreleyebilirsiniz.

  • Trafik grafiği, API başına saniyedeki sorgu sayısı (QPS) cinsinden kullanımını gösterir.

  • Hatalar grafiği, API başına hatayla sonuçlanan isteklerin yüzdesini gösterir.

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

Grafiklerin altındaki bir tabloda etkin API'ler ve hizmetler listelenir. İstekler, isteklerin sayısıdır (seçili dönem için). Hatalar, hatayla sonuçlanan bu isteklerin sayısıdır. Gecikme (orta gecikme 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 başlıklı makaleye 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 bulunur. API'ye göre istekler de grafik biçiminde gösterilir. Faturalandırma grafiği, mevcut faturanızı ve son 3 aya ait toplam kullanımınızı gösterir.

Son 30 gündeki 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 son 30 gün içinde etkin her API için istek sayısı, hata sayısı ve ortalama gecikme süresi 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üde API'ler seçeneğini belirleyin.

Google Haritalar Metrikler sayfası

Google Haritalar'ın 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'a 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 gruplama 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ünlük) 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.

Kimlik bilgisi raporlama

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ı Maps Platform Console'daki Anahtarlar ve Kimlik Bilgileri bölümünde bulabilirsiniz.
Proje Numarası
Örneğin, "proje_numarası:123456". Burada 123456 proje numaranızdır.
Bu kimlik bilgisini görürseniz iki olasılık vardır:
  1. Haritalar Platformu istemci kimliklerini kabul eden API'ler için: API'yi yüklemek için Haritalar Platformu istemci kimliği kullanıldı. Örneğin, &client=gme-_mycompany_ kullanabilirsiniz.

    Bu API'ler 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 bölümüne bakın.

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

Google 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.
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ı 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.
NOT_FOUND 4xx(1) Directions API için bu mesaj, isteğin kaynak, hedef veya ara noktalarında belirtilen konumlardan en az birinin coğrafi kodlamasının yapılamadığını belirtir.

Bu mesaj, Places API için referans verilen 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 ve diğerleri.
4xx Hata, geçersiz parametre değerinden kaynaklanıyor. Daha fazla ayrıntı için API yanıtına bakın.

Bu faturalandırılabilir bir istektir ve kotayı tüketir.
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,
Source_EXHAUSTED,
RateLimitExceeded,
dailyLimitExceeded,
kullanıcı
4xx İzin verilen dönemde çok fazla istekten kaynaklanan istemci hatası. İsteği daha sonra tekrar deneyin. Daha fazla ayrıntı 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 istekten kaynaklanan istemci hatası. Daha fazla ayrıntı için API yanıtına bakın.
NOT_FOUND (404) 4xx Geolocation API'de 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ı tüketir.
UNKNOWN_ERROR 5xx İsteğin işleme koyulamayacağını gösteren sunucu hatası: dahili hata, hizmet aşırı yüklendi, kullanılamıyor, zaman aşımı ve diğerleri.
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'ye 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'e; OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, HTTP için 2xx, rateLimitExceeded kodundan 2xx durumuna, rateLimitExceededREQUEST_DENIEDOVER_DAILY_LIMITuserRateLimitExceeded5xxUNKNOWN_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şmez. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'ndeki 4xx ve/veya 5xx değerlerindeki 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 için ilgilendiğiniz API'nin yanıt belgelerine (ör. Coğrafi Kodlama Yanıtları veya Yol Tarifi Yanıtları) bakın.

Google Haritalar Platformu çözümleri parametresi

Google Haritalar Platformu'nda kısa sürede çalışmaya başlayabilmeniz için birçok örnek kod türü bulunur. Ö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.

Google, kullanımı ve çözümlerimizi geliştirmenin yollarını anlamak için API çağrılarına solution_channel sorgu parametresini dahil eder. Bu parametre, örnek kod kullanımı hakkında bilgi toplar:

  • solution_channel sorgu parametresi varsayılan olarak çözüm örnek koduna eklenir.
  • 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 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. Yani, 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 dakikada. 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österilir.

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'ın 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ın ve istemci kimliklerinizin toplam trafiğini gösterir. İstemci kimliği trafiği, Cloud Console'daki Metrikler grafiğinde de mevcuttur.

Sayfa yalnızca kota tüketen istekleri gösterir: 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, Google Haritalar Platformu API'lerinin çoğu için bir istektir (Haritalar Statik API'si, Street View Static API, Geocoding API, Directions API, Places API, Time Zone API, Geolocation API ve Elevation API), ancak bazı istisnalar vardır:

  • Mesafe Matrisi API'sinde 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, Street View isteği veya Panorama yüklemesidir. Harita yüklemeleri ücretsizdir ve kotayı tüketmez.

Google Cloud Console'da Haritalar'ın Kotalar sayfasının ekran görüntüsü. Rapor, bir seçici kullanarak kotaları API'ye göre gösterir, ardından Harita Yükleri'ni söz konusu API için ayarlanmış kotalara göre 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

Bu 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
Harita Kutuları API'sı 1 İstek
Haritalar Havadan Görünümü API'sı 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) (Rotalar API'si (İşlem Rotaları)) 1 İstek
Routes API (Compute 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
Pollen API 1 İstek
Solar API 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. Daha fazla bilgi için Faturalandırma başlıklı makaleyi inceleyin.

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. Soldaki menüde Raporlar'ı seçerek bağlı faturalandırma hesabının faturalandırma Raporlar sayfasını açın.

Faturalandırma raporu grafiğini okuma

Faturalandırma raporları, maliyeti zaman içinde yığın çizgi grafik olarak gösterir. Varsayılan görünüm, geçerli ayın günlük tahmini maliyetinin yanı sıra geçerli ayın tamamı için tahmini toplam maliyetin yanı sıra, uygulanan kullanıma özel krediler dahil olmak üzere projeye göre gruplandırılmış olarak kullanılan günlük kullanıma özgü maliyetleri gösterir. Grafikteki (ve özet tablosundaki satır) her satır, maliyete göre en yüksekten 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ü kullanarak grafik ve tabloyu gösteren faturalandırma raporu.

İpucu: SKU başına kullanımı ve 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ü, satır öğelerini SKU'ya göre görüntüleyecek şekilde değiştirmek için:
  1. Grafiğin sağ tarafı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. Bunlar, API isteklerinin sunulduğu yere göre filtreleme yapmanıza olanak tanır.

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

Sağ paneldeki Maliyete kredi dahil et onay kutusunu temizleyerek kullanıma özel kredileri hariç tutacak şekilde grafik görünümünü 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:

  • Harcamanızın belirli bir tutara yaklaşması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: (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. Kabul edilebilir tek kanal değerleri 0-999 arasındaki sayılardır. Aşağıda birkaç örnek verilmiştir:

  • Geocoding Web Service API
    https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY&channel=1
  • Maps JavaScript API
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&channel=2&callback=initMap"
    async defer></script>

Kanal kullanımınızı doğrudan Faturalandırma Raporunuzdan izleyin. Kanallar, Etiketler'in altında temel goog-maps-channel olarak gösterilir.

Etiketlere Göre Filtrele
Şekil 4: SKU ve Kanallara Göre Filtreleme
Faturalandırma raporunuzu SKU'ya 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. Anahtar açılır menüsünü açın ve goog-maps-channel'i 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.

İsteklerinizde kanal kullanım verilerini 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

Ayrıca faturalandırma verilerinizi BigQuery'ye 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ızı sağlar. Ardından, ayrıntılı analiz için BigQuery'den faturalandırma verilerinize erişebilirsiniz. Bu sayede, Google Haritalar Platformu'nu kullanımınızın kaynağını daha ayrıntılı bir şekilde anlayabilirsiniz.

BigQuery dışa aktarma işlemlerini başlatmak ve verileri sorgulamak 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 önündeki "gcp_billing_exportv1" olan ve tire (-) yerine alt çizgi (_) gösteren 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
  

Cloud Billing:

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ö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 izleme'deki Yanıt durumu kodları bölümüne bakın.

Google Maps API yanıtlarında kullanılabilen yanıt kodları Kullanım Raporu'nda Bulunabilir Bildirilen grup:
Google 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 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'ye 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'e; OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, HTTP için 2xx, rateLimitExceeded kodundan 2xx durumuna, rateLimitExceededREQUEST_DENIEDOVER_DAILY_LIMITuserRateLimitExceeded5xxUNKNOWN_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şmez. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'ndeki 4xx ve/veya 5xx değerlerindeki 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 analizler, haritadaki görüntülemeler veya ÖY ile etkileşimler gibi önemli 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 şunları 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 amacıyla konsolda belirli bir metriği analiz etmek için ayrıntılı inceleme
  • Favori iş analizi aracınızda işletme analizi verilerini analiz edebilmeniz 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 izleyin. Harita Görünümleri posta koduna göre haftalık olarak hesaplanır (Pasifik saatiyle Pazar-Cumartesi arası). Yeni veriler, gözlem döneminden sonraki ilk Çarşamba günü haftalık olarak yayınlanır.

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

Filtreleme ve Gruplandırma Ölçütü özellikleriyle etkileşim metriklerini doğrudan konsolda analiz ederek metrikleri daha ayrıntılı bir şekilde inceleyebilirsiniz. Örneğin, yalnızca belirli bir bölgedeki posta kodları için harita görüntülemelerinin nasıl trend olduğunu öğrenmek üzere belirli bir bölgeye göre filtreleme yapmayı seçebilirsiniz. Diğer yandan, belirli bir bölgedeki etkileşimleri toplamak için belirli bir bölgeye göre gruplandırmak isteyebilirsiniz.

Kullanıcılar favori iş analizi aracınızda daha fazla analiz yapmak için veri kümesinin tamamını veya filtrelenmiş bir görünümü CSV'ye aktarabilir. Tek seferde en çok 90 gün boyunca indirme yapabilirsiniz. 60 binden fazla hücre indirilir. Harita görünümü verilerini CSV'ye aktarmak, 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şime ilişkin genel eğilimleri yansıtır. Düşük sayılar sıfıra yuvarlanabilir ve aykırı değerlerden gelen katkılar azaltılabilir.

Haritalar Analizleri iznini kullanarak Google Cloud Console'da Cloud projeniz için iş analizlerine erişimi kontrol edebilirsiniz. Proje Sahiplerine bu izin varsayılan olarak verilir 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 edip kullanarak içgörüler oluşturmanıza yardımcı olur. Böylece, müşterilerinizin 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ı da dahil olmak üzere performansınızı haftadan haftaya ölçebilirsiniz. Ayrıca kontrol panelinde, uygulamanızın diğer perakendecilere kıyasla ne durumda olduğu hakkında önemli karşılaştırmalar yer alır.

Karşılaştırma raporu, verilerinizi, verilerini paylaşan diğer şirketlerin 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, Google karşılaştırmalarına anonim olarak eklenir. 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ınız genellikle 3 gün içinde çözülür.