Android Automotive Intents için Google Haritalar

Android intent'leri aracılığıyla Android Automotive için Google Haritalar'da navigasyonu başlatabilirsiniz.

Genel Bakış

Bu sayfada, Android Automotive için Google Haritalar ile kullanabileceğiniz intent'ler açıklanmaktadır. Ayrıntılı Android geliştirici belgeleri için aşağıdakilere bakın:

• Intent'ler ve Intent Filtreleri
• Android platformunda yaygın olarak kullanılan intent'ler

Intent istekleri

Android Automotive için Google Haritalar'ı bir intent ile başlatmak istiyorsanız öncelikle işlemini, URI'sini ve paketini belirterek bir Intent nesnesi oluşturmanız gerekir.

• İşlem. Tüm Google Haritalar intent nesneleri, Görüntüleme işlemi olarak çağrılır, ACTION_VIEW.

• URI. Google Haritalar intent'leri, seçilen bir işlemi ve bu işlemi gerçekleştirmek için gereken bazı verileri belirten URI kodlu dizeleri kullanır.

• Paket. setPackage("com.google.android.apps.maps") çağrısı, Android için Google Haritalar uygulamasının Intent'i işlemesini sağlar. Paket ayarlanmazsa sistem, Intent'i hangi uygulamaların işleyebileceğini belirler. Birden fazla uygulama varsa hangi uygulamayı kullanmak istediğiniz sorulabilir.

Intent'i oluşturduktan sonra sistemin ilgili uygulamayı çeşitli şekillerde başlatmasını isteyebilirsiniz. Yaygın yöntemlerden biri, Intent'i startActivity() yöntemine iletmektir. Sistem, gerekli uygulamayı (bu örnekte Google Haritalar) başlatır ve ilgili Activity işlemini başlatır.

// Create a Uri from an intent string. Use the result to create an Intent.
Uri mapIntentUri =
Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
// Create an Intent from mapIntentUri. Set the action to ACTION_VIEW
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
// Make the Intent explicit by setting the Google Maps package
mapIntent.setPackage("com.google.android.apps.maps");
// Attempt to start an activity that can handle the Intent
startActivity(mapIntent);

Sistem, Intent'e yanıt verebilecek bir uygulama tanımlayamazsa uygulamanız kilitlenebilir. Bu nedenle, bu intent'lerden birini kullanıcıya sunmadan önce alıcı uygulamanın yüklü olduğunu doğrulayın.

Bir uygulamanın intent'i alabileceğini doğrulamak için Intent nesnenizde resolveActivity() yöntemini çağırın. Sonuç boş değilse intent'i işleyebilecek en az bir uygulama vardır ve startActivity() yöntemini çağırmak güvenlidir. Sonuç boşsa intent'i kullanmamanız ve mümkünse intent'i çağıran özelliği devre dışı bırakmanız gerekir.

if (mapIntent.resolveActivity(getPackageManager()) != null) {
...
}

Örneğin, Sydney'deki Taronga Hayvanat Bahçesi'ne adım adım rota başlatmak için aşağıdaki kodu kullanabilirsiniz:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
if (mapIntent.resolveActivity(getPackageManager()) != null) {
startActivity(mapIntent);
}

URI ile kodlanmış sorgu dizeleri

Google Haritalar intent'lerine iletilen tüm dizeler URI kodlamalı olmalıdır. Örneğin, "1st & Pike, Seattle" dizesi 1st%20%26%20Pike%2C%20Seattle olmalıdır. Dizedeki boşluklar %20 ile kodlanabilir veya artı işaretiyle (+) değiştirilebilir.

Dizelerinizi kodlamak için android.net.Uri encode() yöntemini kullanabilirsiniz. Örneğin:

Uri mapIntentUri = Uri.parse("google.navigation:q=" + Uri.encode("1st & Pike, Seattle"));

Harita görüntüleme

Haritayı belirli bir konumda ve yakınlaştırma seviyesinde göstermek için geo: intent'ini kullanın. Örneğin:

geo:latitude,longitude?z=zoom

Parametreler

• latitude ve longitude, haritanın merkez noktasını belirler.

• z, isteğe bağlı olarak haritanın ilk yakınlaştırma seviyesini ayarlar. Kabul edilen değerler 0 (tüm dünya) ile 21 (tek tek binalar) arasında değişir. Üst sınır, seçilen konumda mevcut olan harita verilerine bağlı olarak değişebilir.

Örnek

// Creates an intent that will load a map of San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Konum arayın

Belirli bir görüntü alanındaki arama sorgularını görüntülemek için bu intent'i kullanın:

geo:latitude,longitude?q=query
geo:0,0?q=my+street+address

Parametreler

Arama, harita görüntülemek için kullanılan parametrelerin yanı sıra şu parametreyi de destekler:

• q, haritada vurgulanacak yerleri tanımlar. q parametresi tüm Arama istekleri için zorunludur. Konumu yer adı veya adres olarak kabul eder. Dize, URL çıkışlı olmalıdır. Bu nedenle, "City Hall, New York, NY" gibi bir adres City+Hall%2CNew+York%2CNY biçimine dönüştürülmelidir.

Arama sonuçlarını koordinatlarla yönlendirme

Çok spesifik bir konum ararken q parametresine dahil edilmişse enlem ve boylam kesinlikle gerekli değildir. Ancak tam adresi bilmiyorsanız veya sorgu belirsizse bir koordinat belirterek arama sonuçlarını etkilemeye çalışabilirsiniz. Örneğin, "Ana Cadde" için adres araması yapmak çok fazla sonuç döndürebilir:

// Searching for "101 Main Street" with no lat/long might return too many results
Uri gmmIntentUri = Uri.parse("geo:0,0?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Intent URI'sine enlem ve boylam eklemek, sonuçları belirli bir alana yönlendirir:

// Searches for "101 Main Street" near San Francisco
Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?q=101+main+street");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Rota boyunca arayın

Navigasyon sırasında bir arama amacı geo:latitude,longitude?q=query gönderilirse rota boyunca bir arama tetiklenir ve enlem ile boylam yok sayılır.

Önceden tanımlanmış kategorileri arama

Araçla entegrasyonu desteklemek için araçtaki Google Haritalar, önceden tanımlanmış şu kategorileri gösteren bir intent'i destekler:

Kategori amacı geo:lat,lng?c=category biçimindedir.

Kullanıcının yerel ayarlarından bağımsız olarak c=<pre-defined category> kullanın. Google Haritalar, bu kategori için uygun yerel ayarda alakalı sonuçlar gösterir. Örneğin:

// Search for gas stations nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?c=gas_station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Diğer kategorik aramalar

Kullanıcının yerel ayarında genel bir arama terimi (ör. "restoranlar" veya "kafeler") iletirseniz Android Automotive için Google Haritalar, ölçütlerle eşleşen işletme girişlerini arar. geo: intent'inde belirli bir enlem ve boylam sağlanırsa arama bu konumun etrafında yoğunlaşır. Konum belirtilmezse (ör. geo:0,0) Google Haritalar yakındaki işletme girişlerini bulmaya çalışır. Örneğin:

// Search for restaurants nearby
Uri gmmIntentUri = Uri.parse("geo:0,0?q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Sorgu dizesiyle birlikte bir yakınlaştırma parametresi belirterek arama sonuçlarını daha da daraltabilirsiniz. Aşağıdaki örnekte, 10 yakınlaştırma değeri eklenerek restoranlar yakında değil, şehir düzeyinde aranır:

Uri gmmIntentUri = Uri.parse("geo:37.7749,-122.4194?z=10&q=restaurants");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, gmmIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Adım adım rotayı başlatma

Diğer Android cihazlarda adım adım rota özelliğini başlatmayla ilgili belgeler için Android için Google Haritalar Intent'lerinde adım adım rota özelliğini başlatma başlıklı makaleyi inceleyin.

Belirtilen bir veya daha fazla adres ya da koordinat için adım adım yol tarifleri içeren Google Haritalar navigasyonunu başlatmak üzere bu intent'i kullanın. Yol tarifleri her zaman kullanıcının mevcut konumundan verilir.

google.navigation:q=a+street+address
google.navigation:q=latitude,longitude
google.navigation:place=placename

Parametreler

Gezinmeyi başlatmak için place veya q ile birlikte waypoints (isteğe bağlı) kullanın. Bir ara noktayı isteğe bağlı olarak şarj istasyonu olarak işaretlemek için Elektrikli araç gezi planını Google Haritalar'a gönderme başlıklı makaleyi inceleyin.

• q, gezinme aramaları için uç noktayı ayarlar. Bu, enlem ve boylam veya sorgu biçimli bir adres olabilir. Birden fazla sonuç döndüren bir sorgu dizesiyse ilk sonuç seçilir.

• place, uç noktayı ev veya iş olarak ayarlar. Kullanıcının evine gitmek için "ev", iş yerine gitmek için "iş" değerini belirtin.

• avoid, rotanın kaçınmaya çalışması gereken özellikleri ayarlar. avoid isteğe bağlıdır ve aşağıdakilerden biri veya daha fazlası olarak ayarlanabilir:

  • Geçiş ücreti: t
  • Otoyollar için h
  • Feribotlar için f

• waypoints, yol tariflerini q tarafından belirtilen nihai hedefe yönlendirmek için bir veya daha fazla ara yer belirtir. Yerleri ayırmak için dikey çizgi karakterini (|) kullanarak birden fazla yol noktası belirtebilirsiniz. Örneğin, Berlin,Germany|Paris,France. İstediğiniz sayıda ara nokta kullanabilirsiniz. Ara noktalar, URL'de listelendikleri sırayla rotaya eklenir. Her ara nokta bir adres veya virgülle ayrılmış enlem ve boylam koordinatları olabilir. Aynı amaçta hem adresleri hem de enlem ve boylam koordinatlarını kullanabilirsiniz. Dizeler URL çıkışlı olmalıdır. Bu nedenle, "Berlin,Germany|Paris,France" gibi ara noktalar Berlin%2CGermany%7CParis%2CFrance değerine dönüştürülmelidir.

Örnekler

Bu Intent, Avustralya'nın Sidney şehrindeki Taronga Hayvanat Bahçesi'ne adım adım rota isteğinde bulunur:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Ücretli geçişlerden veya feribotlardan kaçınmak istiyorsanız bu durumlardan kaçınmaya çalışan bir rota isteyebilirsiniz:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&avoid=tf");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Evinize gitmek istiyorsanız şu komutları kullanabilirsiniz:

Uri mapIntentUri = Uri.parse("google.navigation:place=home");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Aşağıdaki üç adrese sırayla adım adım rota başlatmak için Taronga Hayvanat Bahçesi'ni son hedef q, Google Sydney ve Sidney Opera Binası'nı ise ara nokta olarak iletin:

1. Google Sidney

2. Sidney Opera Binası

3. Taronga Hayvanat Bahçesi, Sidney, Avustralya

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7CSydney+Opera+House");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

q parametresine benzer şekilde, ara noktalardan herhangi birini adres yerine virgülle ayrılmış enlem ve boylamla temsil edebilirsiniz. Örneğin, adres yerine Sidney Opera Binası'nın enlem ve boylamını iletirken aynı navigasyonu başlatmak için:

Uri mapIntentUri = Uri.parse("google.navigation:q=Taronga+Zoo,+Sydney+Australia&waypoints=Google+Sydney%7C-33.856159,151.215256");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Google Haritalar'a elektrikli araç gezi planı gönderme

Bazı varış noktalarını elektrikli araç (EV) şarj noktası olarak belirtmek için bu çoklu varış noktası navigasyon intent'ini kullanın. Çoklu yol noktası intent'ini genişleten bu intent, elektrikli araç seyahat planlama uygulamaları ile Google Haritalar arasında şarj noktası bilgilerini senkronize ederek sürücülerin varış noktalarına ulaşmak için yeterli elektrikli araç pil şarjını korumasına yardımcı olur.

Şarj noktaları ve gezi amaçları için:

• Ad ve enlem-boylam bilgisi içermelidir.
• İsteğe bağlı olarak, şarj süresini hesaplamak için kullanılacak bir güç çıkışı içerebilir.

Google, şarj istasyonu adını ve enlem-boylam bilgisini kullanarak eşleşen bir şarj istasyonu yeri bulur ve bağlayıcı türleri, toplamlar, hızlar ve gerçek zamanlı müsaitlik durumu, desteklenen ödeme yöntemleri ve önemli yerler (ÖY) gibi zengin verileri gösterir. Örneğin, navigasyonun son bölümü için açık otoparklarda arabayla yol tarifi, çalışma saatleri, puanlar. Şarj istasyonlarının Google'ın verileriyle iyi eşleşmesi için belirli bir <brand name> kullanın (ör. ChargePoint).

Parametreler

Aşağıdaki parametreler, nihai varış noktası ve elektrikli araç şarj istasyonu olarak belirlenenler de dahil olmak üzere tüm ara noktalarla ilgili ayrıntıları belirtmenize olanak tanır.

Son varış noktası

Bir şarj istasyonunu son hedef olarak ayarlamak için şunları kullanın:

• q: Şarj istasyonunun enlem ve boylam değerini içermelidir.
• q_type: 1, son varış noktasının bir şarj istasyonu olduğunu belirtir.
• q_name: Son varış noktasının adı. q_type, 1 ise zorunludur.
• q_power_output_kw: Şarj istasyonunun kilovat cinsinden güç çıkışı için ondalıklı sayı. İsteğe bağlı.

Ara noktalar

Ara noktalar için tüm parametreler, ara noktalarla aynı sırada olan ve son hedefi içermeyen, dikey çizgiyle ayrılmış (|) paralel değer dizileridir. Paralel dizilerdeki öğe sayısının uyuşmaması, hatalı biçimlendirilmiş amaç olarak değerlendirilir.

Bir veya daha fazla şarj istasyonu ara noktası eklemek için aşağıdaki parametreleri kullanın. Bu parametrelerin tümü isteğe bağlıdır. Hedeflerden biri şarj istasyonu olarak işaretlenirse bu hedef için yol noktası adı zorunlu hale gelir.

• waypoints: Adım adım rota intent'inde açıklandığı şekilde yol noktalarının listesi. Şarj istasyonu ara noktaları için enlem-boylam değeri olmalıdır.

• waypoint_types: Sayı olarak belirtilen, her bir ara nokta için türler. 0 herhangi bir durak (varsayılan değer) ve 1 şarj istasyonudur.

• waypoint_names: Yol noktası adları. Bu alan, şarj istasyonları için zorunludur.

• waypoint_power_outputs_kw: Şarj istasyonu gücü için kilovat cinsinden ondalıklı sayılar. Şarj istasyonları için isteğe bağlı olarak bir ara nokta güç çıkışı değeri belirtebilirsiniz. Bu değer, eşleşen istasyon bulunamazsa yedek olarak kullanılır. Boş alan, değer sağlanmadığı anlamına gelir.

Kullanıcı deneyimi (UX) davranışı

Birden fazla varış noktası olan seyahat amaçları için rotaya genel bakış ekranı gösterilir ancak navigasyon otomatik olarak başlatılmaz.

Doğru biçimlendirilmiş bir intent için Google Haritalar, seyahatle ilgili rotaya genel bakış ekranını gösterir. Rotaya genel bakış ekranında, tüm ara noktalar ve amaçtaki son hedef, uygun durumlarda şarj önerileriyle birlikte gösterilir.

Google Haritalar, şarj istasyonu olarak işaretlenen tüm ara noktalar veya nihai varış noktaları için Google'ın veritabanında eşleşen bir yer arar. Şarj istasyonları için mümkün olan en iyi bilgilerin gösterilmesini sağlamak amacıyla:

• Eşleşme bulunursa Google Haritalar, şarj istasyonunu kullanıcı arayüzünde (UI) göstermek ve şarj istasyonu için şarj önerisi sunmak üzere Google verilerini kullanır.

• Eşleşme bulunamazsa şarj istasyonu için intent'te sağlanan veriler (enlem-boylam, ad ve güç çıkışı), bu şarj istasyonunu kullanıcı arayüzünde göstermek ve bu şarj istasyonunda şarj önerisi sunmak için kullanılır.

Örnekler

Aşağıdaki örneklerde, birden fazla şarj istasyonundan geçerek rota oluşturma ve bilinmeyen güç çıkışlarını işleme dahil olmak üzere çeşitli EV gezi planlama senaryoları için intent'lerin nasıl oluşturulacağı gösterilmektedir.

Birden fazla şarj istasyonundan geçerek varış noktasına gitme

Aşağıdaki intent, ChargePoint ve Evie adlı iki şarj istasyonundan geçerek son varış noktası olan Port Macquarie NSW'ye gider.

Sırasıyla hedefler:

1. ChargePoint Şarj İstasyonu (konum: -32.9599188,151.6240806, güç çıkışı: 6,6 kW)

2. Evie Şarj İstasyonu (konum: -31.9432539,152.4699808, güç çıkışı: 350 kW)

3. Port Macquarie, Yeni Güney Galler

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806%7C-31.9432539%2C152.4699808"
            + "&waypoint_types=1%7C1"
            + "&waypoint_names=ChargePoint+Charging+Station%7CEvie+Charging+Station"
            + "&waypoint_power_outputs_kw=6.6%7C350");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Bilinmeyen güç çıkışı

Güç çıkışı değeri bilinmiyorsa waypoint_power_outputs_kw için ilgili alanı boş bırakın. Tüm alanlar boşsa waypoint_power_outputs_kw parametresini belirtmeniz gerekmez.

Sırasıyla hedefler:

1. ChargePoint Şarj İstasyonu (konum: -32.9599188,151.6240806, güç çıkışı: bilinmiyor)

2. Port Macquarie, Yeni Güney Galler

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=Port+Macquarie+NSW"
            + "&waypoints=-32.9599188%2C151.6240806"
            + "&waypoint_types=1"
            + "&waypoint_names=ChargePoint+Charging+Station");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

Son varış noktasını şarj istasyonu olarak işaretleme

Son varış noktasını şarj istasyonu olarak işaretlemek için q_type, q_name ve q_power_output_kw parametrelerini belirtin.

Sırasıyla hedefler:

1. Taronga Hayvanat Bahçesi, Sidney, Avustralya

2. ChargePoint Şarj İstasyonu (konum: -32.9599188,151.6240806, güç çıkışı: bilinmiyor)

3. Evie Şarj İstasyonu (konum: -31.9432539,152.4699808, güç çıkışı: 350 kW)

Uri mapIntentUri =
    Uri.parse(
        "google.navigation:q=-31.9432539,152.4699808&q_type=1&q_name=Evie+Charging+Station&q_power_output_kw=350"
            + "&waypoints=Taronga+Zoo%2C+Sydney+Australia%7C-32.9599188%2C151.6240806"
            + "&waypoint_types=0%7C1"
            + "&waypoint_names=%7CChargePoint+Charging+Station"
            + "&waypoint_power_outputs_kw=%7C");
Intent mapIntent = new Intent(Intent.ACTION_VIEW, mapIntentUri);
mapIntent.setPackage("com.google.android.apps.maps");
startActivity(mapIntent);

İşlem amaçları

Arayüzlere sahip aşağıdaki işlem amaçları kullanılabilir: