Zenginleştirilmiş İşlemler uygulama kılavuzu

Genel bakış

web iOS API

Web (JS, TS), Android ve iOS'te kullanılabilen Google Haritalar Platformu; yerler, yol tarifleri ve mesafeler hakkında bilgi edinmek için web hizmetleri API'leri de sunar. Bu kılavuzdaki örnekler bir platform için yazılmıştır ancak diğer platformlarda uygulama için doküman bağlantıları sağlanmıştır.

Kullanıcılar, işlem ifadelerini genellikle anlamakta zorlanır. "Acme Ev Ürünleri" gibi satıcı adları yerine "ACMEHCORP" gibi kısaltmalar kullanılması, müşteri desteği çağrılarının artmasına ve yol açıcı anlaşmazlıklara yol açabilir. Zenginleştirilmiş İşlemler, satıcının tam adı ile işletme kategorisi, vitrin fotoğrafı, harita üzerinde adresi ve konumu, tam iletişim bilgileri ve daha fazlasını sağlayarak bu işlemleri basitleştirip sezgisel hale getirir. Bu durum kullanıcı memnuniyetini ve şeffaflığı artırırken müşteri desteği çağrılarını azaltabilir, NPS'yi artırabilir ve uygulama içinde daha fazla zaman geçirebilir.

Zenginleştirilmiş İşlemler (bu konuda sunduğumuz uygulama kılavuzu ve özelleştirme ipuçları), harika işlem geçmişi kullanıcı deneyimleri oluşturmak için Google Haritalar Platformu API'lerinin en iyi kombinasyonu olarak önerilir. Bu uygulama kılavuzu, bir konumu belirli bir satıcıyla nasıl eşleştireceğinizi ve bu satıcının ayrıntılı bilgilerini nasıl göstereceğinizi gösterir.

Zenginleştirilmiş işlemler örnek ekranları
Zenginleştirilmiş işlemler örnek ekranları (büyütmek için tıklayın)

API'ler etkinleştiriliyor

Zenginleştirilmiş İşlemler uygulamak için Google Cloud Console'da aşağıdaki API'leri etkinleştirmeniz gerekir. Aşağıdaki köprüler, seçtiğiniz projede her bir API'yi etkinleştirmeniz için sizi Google Cloud Console'a yönlendirir:

Kurulum hakkında daha fazla bilgi için Google Haritalar Platformu'nu kullanmaya başlama başlıklı makaleyi inceleyin.

Uygulama rehberi bölümleri

Aşağıda, bu konuda ele alacağımız uygulamalar ve özelleştirmeler verilmiştir.

  • Onay işareti simgesi, temel uygulama adımlarından biridir.
  • Yıldız simgesi isteğe bağlı ancak çözümü geliştirmek için önerilen bir özelleştirmedir.
Satıcıları Google Haritalar Platformu ile eşleştirme İşlem geçmişindeki bir satıcıyı Google Haritalar Platformu'ndaki bir yerle ilişkilendirme.
Satıcı ayrıntılarını görüntüleme Kullanıcıların işlemi hızlıca tanıyabilmesi için satıcı hakkında faydalı bilgiler içeren veri açısından zengin işlemler gösterin.
Satıcının bulunduğu yerin haritasını ekleme Satıcının bulunduğu yerin haritasını ekleyin.

Satıcıları Google Haritalar Platformu ile eşleştirme

Bu örnekte kullanılan alan: Places API

Aşağıdaki şemada, uygulamanızın mevcut bir satıcı veritabanından veya bir Yer Arama isteği üzerinden Yer Ayrıntılarını kullanarak bir sonuç döndürmek için satıcı işlemlerini nasıl eşleştirdiği gösterilmektedir:

Satıcı eşleştirme akış matrisi
Satıcı eşleştirme akış matrisi (büyütmek için tıklayın)

Google Haritalar Platformu yer kimliklerini alma

İşletme adı ve adresi gibi temel bilgileri içeren bir satıcılar veritabanınız olabilir. Google Haritalar Platformu'nun iletişim bilgileri ve kullanıcılar tarafından sağlanan bilgiler de dahil olmak üzere bu yer hakkında sahip olduğu bilgileri almak için veritabanınızdaki her bir satıcıya karşılık gelen Google Haritalar Platformu yer kimliğine ihtiyacınız vardır.

Bir işletmenin yer kimliğini almak için Places API'deki /findplacefromtext uç noktasına istekte bulunun ve isteği ücretsiz Yer Bulma - Yalnızca kimlik çağrısı olarak faturalandırmak için yalnızca place_id alanını isteyin. Satıcının birden fazla konumu varsa satıcı adını şehir veya sokak adıyla birlikte kullanın. Aramanın döndürdüğü verilerin kalitesi değişiklik gösterir. Bu yüzden, döndürülen sonuçların gerçekten istenen satıcıyla eşleşip eşleşmediğini doğrulamanız gerekir.

Aşağıda, satıcı adı ve şehri kullanarak Google Taipei ofisi için yer kimliği isteğinde bulunmayla ilgili bir örnek verilmiştir:

https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=google%20taipei&inputtype=textquery&fields=place_id&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

API isteğindeki giriş parametresini URL olarak kodladığınızdan emin olun.

Yer kimliklerini depolama

Gelecekteki isteklere yönelik olarak Google Haritalar Platformu'ndan satıcıyla ilgili bilgileri depolamak için bu yer kimliğini satıcı kaydının bir özelliği olarak veritabanınızda süresiz olarak depolayabilirsiniz. Yer Bulma isteğini her satıcı için yalnızca bir kez yapmanız gerekir. Ayrıca, kullanıcılar işlem ayrıntılarını her istediğinde yer kimliğini arayabilirsiniz.

Her zaman en doğru bilgilere sahip olduğunuzdan emin olmak için place_id parametresiyle bir Yer Ayrıntıları isteği kullanarak 12 ayda bir Yer Kimliklerini yenileyin.

Gösterdiğiniz Yer Ayrıntıları, işlemi gerçekleştiren satıcıyla eşleşmiyorsa kullanıcıların satıcı eşleşmesinin kalitesi hakkında geri bildirim paylaşmalarına izin vermenizi öneririz.

Satıcı ayrıntıları gösteriliyor

Bu örnekte kullanılan alan: Places API Ayrıca kullanılabilir: Android için Yerler SDK'sı | iOS için Yerler SDK'sı | Places Library, Maps JavaScript API

Kullanıcıların konumlarınızdan birini ziyaret ettikten sonra bilmesi gereken Yer Ayrıntılarını paylaşabilirsiniz. İletişim bilgileri, çalışma saatleri, kullanıcı puanları ve kullanıcı fotoğrafları gibi zengin Yer Ayrıntıları ile uygulamanız kullanıcılara tamamladıkları işlemi hatırlatabilir. Yer Ayrıntılarını almak için Places API'ye çağrı yaptıktan sonra yanıtı bir bilgi penceresinde, web kenar çubuğunda veya istediğiniz başka bir şekilde filtreleyebilir ve oluşturabilirsiniz.

Örnek satıcı ayrıntıları ekranı
Örnek satıcı ayrıntıları ekranı (büyütmek için tıklayın)

Yer Ayrıntıları istemek için konumlarınızın her birinin yer kimliğine ihtiyacınız vardır. Bulunduğunuz konumun yer kimliğini almak için Yer kimliklerini alma makalesine bakın.

Aşağıdaki Yer Ayrıntıları isteği, Google Taipei 101 yer kimliği için json çıktısında adresi, koordinatları, web sitesini, telefon numarasını, puanı ve saatleri döndürür:

https://maps.googleapis.com/maps/api/place/details/json?placeid=ChIJraeA2rarQjQRyAqIxkx2vN8&fields=name%2Cformatted_address%2Cwebsite%2Cformatted_phone_number%2Cgeometry/location%2Cicon%2Copening_hours%2Crating&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Satıcının bulunduğu yerin haritasını ekleme

Bu örnekte şunlar kullanılmaktadır: GeoCode API | Maps Static API Diğer sürümler: Android | iOS

Satıcının konumunu belirleme

Maps Static API, işaretçi yerleştirmek için bir adres veya koordinatları kabul eder. Satıcı kaydınızın zaten bir adresi varsa sonraki bölüme geçebilirsiniz. Ancak harita hassasiyeti için adresler üzerinde koordinatları kullanmanızı öneririz.

Satıcı veritabanınızda açık adresler varsa ancak coğrafi koordinatlar içermiyorsa ve halihazırda Yer Ayrıntıları isteğinde bulunmuyorsanız, açık adresleri sunucu tarafında enlem/boylam koordinatlarına dönüştürmek, koordinatları veritabanınızda saklamak ve koordinatları en az 30 günde bir yenilemek için Coğrafi Kodlama API'sini kullanabilirsiniz.

Aşağıda, Google Taipei ofis yeri kimliğinin enlem ve boylamını almak için Coğrafi Kodlama API'sinin kullanıldığı bir örnek verilmiştir:

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJraeA2rarQjQRyAqIxkx2vN8&key=YOUR_API_KEY&solution_channel=GMP_guides_enrichedtransactions_v1_a

Haritaya satıcı konumu için işaretçi ekleme

Kullanıcılarınız, haritaya göz atmak veya gezinmek yerine işlemleri onaylamak için haritayı göreceğinden, etkileşimi sınırlı olan bir harita oluşturmak istersiniz.

Masaüstü ve mobil web için satıcının enlem/boylam kısmında veya adresinde tek bir işaretçi içeren bir Maps Static API URL'si oluşturun. Maps Static API'yi bir web hizmeti çağrısı kullanarak kullanabilirsiniz. Bu işlem, belirttiğiniz parametrelerle bir haritanın resim sürümünü oluşturur. Mobil cihazlar için bir sonraki Mobil uygulamanıza harita ekleme bölümüne atlayın.

Aşağıdaki çağrıda, Google Taipei ofisindeki varsayılan yakınlaştırma düzeyinde bir işaretçinin merkezinde yer alan 640x480 piksel boyutunda bir yol haritası gösterilmektedir. Ayrıca kırmızı bir teslimat konumu işaretçisi ve Bulut tabanlı bir harita stili belirtir:

    https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:red%7C25.033976%2C121.5645389&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Bu, aşağıdaki bölümlere ayrılır:

API URL'si https://maps.googleapis.com/maps/api/staticmap?
Resim boyutu boyut=640x480
Satıcı konumu işaretçileri (URL kodlaması kullanılır) işaretçi=renk:kırmızı%7C25.033976%2C121.5645389
Bulut tabanlı harita stili harita_kimliği=b224095f76859890
API Anahtarı key=API_ANAHTARINIZ
Dijital imza (İsteğinizi dijital olarak nasıl imzalayacağınızı öğrenin) imza=BASE64_SIGNATURE
Çözüm kanalı parametresi (Parametre dokümanlarına bakın) problem_channel=GMP_guides_enrichedtransactions_v1_a

Bu, aşağıda gösterildiği gibi resim haline gelir:

Google Taipei Ofisi'nin statik harita görüntüsü

İşaretçi konumu olarak bir adresi de kullanabilirsiniz:

https://maps.googleapis.com/maps/api/staticmap?size=640x480&markers=color:green%7CTaipei%20101%20Tower%2CNo.%207信義路五段信義區台北市%20Taiwan%20110&map_id=b224095f76859890&key=YOUR_API_KEY&signature=BASE64_SIGNATURE&solution_channel=GMP_guides_enrichedtransactions_v1_a

Ek parametre seçenekleri için Haritalar Statik API dokümanlarına bakın.

Mobil uygulamanıza harita ekleme

Android için Haritalar SDK'sını veya iOS için Haritalar SDK'sını kullanıyorsanız Yer Ayrıntıları'ndaki bilgilerden alınan koordinatları kullanarak işaretçi yerleştirebilirsiniz.

Kullanıcılarınız, göz atmak veya gezinmek yerine işlemleri onaylamak için haritayı göreceğinden, etkileşimi sınırlı olan bir harita seçin: