Genel bakış
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.
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:
- Places API.
- Coğrafi Kodlama API'si.
- Haritalar Static API, Android için Haritalar SDK'sı veya iOS için Haritalar SDK'sı.
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:
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.
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:
İş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:
- Android uygulamaları için İşaretçi eğitimiyle harita ekleme konusuna bakın ve sınırlı etkileşim sağlamak için basit modu etkinleştirin.
- iOS uygulamaları için İşaretçi eğitimiyle harita ekleme ve
GMSUiSettings
işaretiyle denetimleri ve hareketleri devre dışı bırakma konularına bakın.