Google Haritalar Platformu Raporlaması

Google Haritalar Platformu'ndaki raporlama, Google Cloud Console'da temel API kullanımı, kota ve fatura bilgilerine dair önceden tanımlanmış bir dizi görsel rapor sunar. Bu raporları kullanarak yaptığınız 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ızı 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 istekler şeklinde gruplanabilen grafikler halinde 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ı: Maliyetleri zaman içinde yığın çizgi grafiği olarak bildirir. Geçerli ayın tamamı için tahmini toplam maliyetin yanı sıra kullanıma özel tüm krediler dahil olmak üzere geçerli ayın kota kullanımını 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ğ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 göz atın.

Cloud Console 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 yaptığı istek sayısına bağlıdır. İstekler arasında başarılı istekler, sunucu hatalarıyla sonuçlanan istekler ve istemci hatalarıyla sonuçlanan istekler yer alır. Kimlik bilgileri, API anahtarlarını ve istemci kimliklerini (Premium Plan ve taşınan Premium Plan projeleri için) içerir. 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 amacıyla:

• Tüm API'ler: Tüm API'ler için kullanım metriklerini şu yöntemlerle filtreleyebilir ve gruplayabilirsiniz:

  • Dönem ve API'ye göre filtreleyin.
  • Yanıt kodu, API ve kimlik bilgilerine göre gruplandırılmış trafik, hata ve gecikme bilgilerini görüntüleyin.

• Belirli bir API: Belirli bir API için kullanım metriklerini şu şekillerde filtreleyebilir ve gruplayabilirsiniz:

  • 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 bilgilerini 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'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 dönem seçerek grafiklerde ve tablolarda görüntülenen kullanımı filtreleyebilirsiniz.

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

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

• Gecikme grafiğinde, API başına isteklerin gecikme ortanca değeri gösterilir.

Grafiklerin altında, etkin API'ler ve hizmetler bir tabloda listelenmiştir. İstekler, istek sayısıdır (seçilen dönem için). Hatalar, hatayla sonuçlanan bu isteklerin sayısıdır. Gecikme (orta gecikme ve yüzdelik), bu isteklerin gecikmesidir.

API'ler ve Hizmetler Kontrol Paneli sayfasına erişmek için:

1. Cloud Console'da Proje seçici sayfasını açın:

   Proje seçici sayfası

2. Projenizi seçin. API'ler ve Hizmetler Kontrol Paneli sayfası görünür.
   
   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, 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.

Not: Etkin API'lerden birinin adını seçerseniz bu API'nin Google Haritalar Metrikler sayfasına yönlendirilirsiniz.

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'leri sayfasında iki tablo bulunur. Etkin API'ler tablosunda istek sayısı, hata sayısı ve etkin API'lerin son 30 gündeki ortalama gecikme süresi gösterilir. Ek API'ler tablosunda etkinleştirilmemiş API'ler listelenir.

Not: Etkin API'lerden birinin adını seçtiğinizde o API'nin Google Haritalar Metrikler sayfasına yönlendirilirsiniz.

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'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 Alan Adına göre gruplandırılabilir.

Grafiklerin altında, Metrikler sayfası seçtiğiniz API'lere ilişkin 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 dönem (bir saatten son 30 güne kadar) ve ayrıntı düzeyi (saniye veya gün başına) seçebilirsiniz.

Not: Gruplandırma ölçütü açılır listesindeki Platform ve Alan seçeneği ile Platform ve Alan filtreleri yalnızca API seçimi açılır listesinden tek bir API seçtiğinizde görünür.

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:

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=... kullanılarak API'yi yüklemek için bir API anahtarı kullanıldı: Anahtar adlarını, Haritalar Platformu Konsolu'ndaki Anahtarlar ve Kimlik Bilgileri altında bulabilirsiniz.
Proje Numarası Örneğin, "proje_numarası:123456". Burada 123456, proje numaranızdır.	Bu kimlik bilgisini görüyorsanız iki olasılık vardır: Haritalar Platformu istemci kimliklerini kabul eden API'ler için: API'yi yüklemek için bir Haritalar Platformu istemci kimliği kullanıldı. Örneğin, &client=gme-_mycompany_. 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. OAuth'u kabul eden API'ler için: API, API anahtarı olmadan OAuth kullanılarak yüklenmiştir.

Not: Hem Haritalar Platformu istemci kimliklerini hem de OAuth'u destekleyen Haritalar Platformu API'si yoktur. Bu sayede, API'nin kullanılan API'ye göre bir istemci kimliği ile mi yoksa OAuth ile mi yüklendiğini anlayabilirsiniz.

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 başlangıç noktası, hedefi ya da ara noktalarında belirtilen konumlardan en az birinin coğrafi kodlaması yapılamadığını belirtir. Places API için bu mesaj, 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 ve diğerleri.	4xx	Hata, geçersiz parametre değerinden kaynaklanıyor. Daha fazla ayrıntı için API yanıtına göz atın. Bu faturalandırılabilir bir istektir ve kotayı tüketir.
REQUEST_DENIED	4xx	Kimlik doğrulama hatası, erişim hatası ve benzeri bir sorundan kaynaklanan istemci hatası. Daha fazla ayrıntı için API yanıtını kontrol edin.
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, rateLimitExceeded, DailyLimitExceeded, userRateLimitExceeded	4xx	İzin verilen dönem başına ç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 bilgi için API yanıtına göz atın.
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'de bu mesaj, girişlerin yollara makul şekilde tutturılamadığını gösterir. Bu faturalandırılabilir bir istektir ve kotayı tüketir.
UNKNOWN_ERROR	5xx	İsteğin işleme alınamayacağı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 konumuna 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 4xx olacak şekilde: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, {15'ten 2xx API'sine yanıt, userRateLimitExceededrateLimitExceeded5xxUNKNOWN_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ştirilmez. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'ndeki 4xx ve/veya 5xx değerlerinin bu taşıma işlemiyle ilişkili 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, kısa sürede çalışmaya başlamanız 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.

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

• 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 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 tüm analiz ve raporlardan ayrıdır. Bu, parametrenin çözüm örnek kodundan kaldırılması dahili Maps JavaScript API raporlamasını devre dışı bırakmadığı anlamına gelir.

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ında bulunan grafikler halinde gösterilir ve dakika başına istek sayısına göre gruplanabilir. 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ünde dakika başına kota değerinizi öğrenmek için bu hesap makinesini kullanın.

Google Haritalar Kotalar sayfası

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

Bu 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).

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ı tüketmez ve gösterilmez.

Kota birimi, Google Haritalar Platformu API'lerinin çoğu için bir istektir (Haritalar Statik API'si, Street View Static API, Street View Static API, Geocoding API, Directions API, Yerler API'si, Time Zone API, Geolocation API ve Elevation API) 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 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 veya Panorama yüklemesidir. Harita yüklemeleri ücretsizdir ve kotayı tüketmez.

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
Maps
Android için Haritalar SDK'sı	1 Panorama
iOS için Haritalar SDK'sı	1 Panorama
Harita Parçaları API'sı	1 İstek
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) [Rotalar API'si (İşlem Rotaları)]	1 İstek
Routes API (Compute Route Matix) (İş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
Pollen API	1 İstek
Solar API	1 İstek

Faturalandırma raporları

Faturalandırma raporunuzu görüntüleme

Google Haritalar Platformu ürünleri kullanımınızla ilgili faturalandırma raporlarına Google Cloud Console'dan ulaşabilirsiniz. Daha fazla bilgi için Faturalandırma bölümüne bakın.

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 ve ardından Faturalandırma'yı seçin.
4. Birden fazla faturalandırma hesabınız varsa bağlı faturalandırma hesabının Genel Bakış sayfasını açmak için Bağlı faturalandırma hesabına git'i seçin.
5. 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çindeki yığınlı çizgi grafik olarak gösterir. Varsayılan görünüm, uygulanan kullanıma özel krediler dahil olmak üzere mevcut ayın günlük kullanıma özel maliyetlerini projeye göre gruplandırılmış olarak (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 büyükten küçüğe sıralanan projeye karşılık gelir. Faturalandırma raporu grafiğini yorumlama hakkında daha fazla bilgi edinin.

Ş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 şekilde anlamak için SKU'ya göre kullanımınıza ve maliyetinize bakın.

Şekil 2: SKU'ya göre kullanım ve maliyet satır öğelerini gösteren faturalandırma tablosu.

Ş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ğı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 Yerler 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ı 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 (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 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ç tutmak için grafik görünümünü değiştirebilirsiniz.

Kullanımı 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ı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 sayısı sınırı (bir API için).

  Not: Uygulamanızda birden fazla faturalandırılabilir API kullanılabilir. Bu nedenle denkleminizi gerektiği gibi düzenleyin. Her ay 200 ABD doları değerinde Google Haritalar Platformu kredisi kullanabileceğinizi unutmayın. Bu nedenle, hesaplamanıza bu krediyi dahil etmeyi unutmayın.

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

Not: Kanal verileri Android için Haritalar SDK'sı, iOS için Haritalar SDK'sı, Places API (Yeni), Address Validation API, Aerial View API, Air Quality API, Map Tiles API, Roads API, Routes API, Pollen API ve Solar API'de kullanılamaz.

Ş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. Anahtar açılır menüsünü ve ardından goog-maps-channel'i seçin.
4. Değer açılır listesini seçin 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 ekledikten sonra, bu 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ı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 daha ayrıntılı bir şekilde anlaşılmasını sağlayabilirsiniz.

BigQuery dışa aktarma işlemlerine başlamak 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 şeklindedir. 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 kısa çizgileri (-) alt çizgi (_) olarak değiştiren bir referanstır. Örneğin, 123456-7890AB-CDEF01 faturalandırma hesabı kimliği gcp_billing_export_v1_123456_789AB_CDEF01 olur.

Not: Yeni bir Veri Kümesi oluşturduğunuzda bu veri kümesi arayüzde hemen görünür ancak sorgulanacak tablo henüz görünmez. Tablo birkaç saat sonra otomatik olarak oluşturulur. Daha sonra verilerinizin görünmesi yaklaşık 24 saat sürer. BigQuery veri kümeniz yalnızca faturalandırma dışa aktarımını ayarladığınızda ve sonrasında gerçekleşen kullanım ve maliyet verilerini yansıtır. Başka bir deyişle, faturalandırma verileri geriye dönük olarak eklenmez. Bu yüzden BigQuery Export'u etkinleştirmeden önceki faturalandırma verilerini görmezsiniz.

  #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çeler ve bütçe uyarıları ayarlayın
• API Kullanımını Sınırlama

Google Haritalar Platformu:

• Google Haritalar Platformu Faturalandırması
• Optimizasyon Kılavuzu
• API Anahtarı İçin En İyi Uygulamalar

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 ve ilgili isteğin Kullanım, Kota ve Faturalandırma raporlarında görünüp görünmediği belirtilmektedir.

Not: Geçmişteki nedenlerle, Google Haritalar Platformu API isteklerine yanıt olarak döndürülen HTTP yanıt kodu, Kullanım raporlarındaki (Google Haritalar Platformu Metrikleri) HTTP yanıt kodundan farklı olabilir. Kullanım Raporları metrikleri, yeni API'lerde kullanılanlarla tutarlı olan bir dizi yanıt kodu değeri kullanır. Bu, Google Haritalar Platformu Metrikleri ve Google Haritalar Platformu İzleme'de API kullanımının gözlemlenebilirliğini artırır.

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

Yanıt kodları Maps API yanıtlarında kullanılabilir		Kullanım Raporu'nda mevcut	Bildirilen hesap:
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	4xx^1	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	4xx^1	Evet	Hayır	Hayır
OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, RESOURCE_EXHAUSTED, dailyLimitExceeded, rateLimitExceeded, userRateLimitExceeded	200, 403, 429	4xx^1	Evet	Hayır	Hayır
UNKNOWN_ERROR	200, 500, 503	5xx^1	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 konumuna 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 4xx olacak şekilde: REQUEST_DENIED, OVER_DAILY_LIMIT, OVER_QUERY_LIMIT, dailyLimitExceeded, OVER_QUERY_LIMIT, dailyLimitExceeded, {15'ten 2xx API'sine yanıt, userRateLimitExceededrateLimitExceeded5xxUNKNOWN_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ştirilmez. Metrik Gezgini'nde tam olarak hangi yanıt kodunun arttığını kontrol ederek Google Haritalar Platformu Metrikleri'ndeki 4xx ve/veya 5xx değerlerinin bu taşıma işlemiyle ilişkili olduğunu onaylayın (Google Haritalar Platformu için Google Cloud Monitoring'i kullanma hakkında daha fazla bilgi edinin).

Etkileşim raporları

Bu ürün veya özellik deneyseldir (GKST öncesi). GKST öncesi ürün ve özelliklere verilen destek sınırlı olabilir ve bu ürün ve özelliklerde yapılan değişiklikler, GKST öncesi diğer sürümlerle uyumlu olmayabilir. GKST Öncesi Teklifler, Google Haritalar Platformu Hizmetine Özel Şartlar'ın kapsamındadır. Daha fazla bilgi için lansman aşamalarının açıklamalarını inceleyin.

İş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. Bu bilgileri analiz ederek reklamcılık ve pazarlama için popüler konumları ortaya çıkarabilir veya kullanıcı deneyiminizi optimize 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 edebilmek için metrikleri CSV'ye aktarma

Mevcut etkileşim metrikleri şunlardır:

• Harita Görünümleri: Harita üzerinde kaydırma, yakınlaştırma veya yatırma hareketlerinden kaynaklanan görünümleri izleyin. Harita Görünümleri haftalık olarak posta koduna göre hesaplanır (Pasifik Saati ile Pazar-Cumartesi arası). Yeni veriler her hafta, 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 analizleri görebilir. Projede Haritalar JavaScript API etkin olmalıdır.

Metrikleri daha ayrıntılı bir şekilde incelemek için Filtreleme ve Gruplandırma Ölçütü özellikleriyle etkileşim metriklerini doğrudan konsolda analiz edebilirsiniz. Örneğin, harita görüntülemelerinin yalnızca bir 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ölgedeki etkileşimleri toplamak için belirli bir bölgeye göre gruplandırma yapmak isteyebilirsiniz.

Kullanıcılar, en sık kullandığınız işletme analizi aracında daha ayrıntılı analiz 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 indirebilirsiniz. 60 binden fazla hücre indirmeleri kısaltılır. Harita görünümü verilerini CSV'ye aktarma işlemi, seçilen zaman aralığına bağlı olarak birkaç dakika sürebilir.

İşletme analizleri metrikleri anonimleştirilmiştir ve bu nedenle yalnızca haritalarınızla etkileşimdeki genel eğilimleri yansıtır. Düşük sayılar sıfıra yuvarlanabilir ve aykırı değerlerden kaynaklanan katkılar azaltılabilir.

Haritalar Analizleri 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 bir analiz kontrol paneli, verilerinizden analizler elde etmenize ve bu verilerden bilgiler 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ı 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ğuyla ilgili önemli karşılaştırmalar yer alır.

• 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, 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 verilerinin görülebilmesi için, etkileşim verileriniz anonim olarak Google karşılaştırmalarına 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ı genellikle 3 gün içinde çözülür.