Haritalar URL'leri; arama yapmak, yol tarifi ve navigasyon almak, harita görünümlerini görüntülemek, yerlerin kısa listesini oluşturmak veya Street View panoramalarını göstermek için Google Haritalar'ı başlatan evrensel, platformlar arası bir URL oluşturmanıza olanak tanır. URL söz dizimi her platformda aynıdır ve API anahtarı gerekmez.
Haritalar URL'leri: Temel bilgiler
- Ürün: Haritalar URL'leri
- Diğer adları: Google Haritalar URL'leri
- Kategori: Haritalar
- Platform: URL şeması
- Lansman aşaması: GA
- Yaşam döngüsü: Etkin
- Genel bakış: Haritalar URL'lerine genel bakış
Haritalar URL'leri: Ne zaman kullanılır?
Haritalar URL'lerini şu durumlarda kullanın:
- Bir yeri aramak veya arama sonuçlarını göstermek için Android uygulamanızdan, iOS uygulamanızdan ya da web sitenizden Google Haritalar'ı açan bir bağlantıya ihtiyacınız vardır.
- Google Haritalar'ı noktalar arasındaki yol tarifleriyle (isteğe bağlı olarak yol noktaları, seyahat modu veya adım adım rota ile) açmanız gerekir.
- Google Haritalar'ı API anahtarı kullanmadan harita görünümü, kısa bir yer listesi veya Street View panoraması olarak açmanız gerekir.
- Android, iOS ve masaüstü tarayıcılarda aynı şekilde çalışan bir URL söz dizimine ihtiyacınız vardır.
Haritalar URL'lerini şu durumlarda kullanmayın:
- Zaten Yer Ayrıntıları isteğinde bulunuyorsunuz ve bir yer için önceden biçimlendirilmiş Google Haritalar bağlantıları (
googleMapsUriveyagoogleMapsLinksalanları) istiyorsunuz. Bunun yerine Places API'yi (Yeni) kullanın. - Google Haritalar uygulamasını başlatırken yalnızca mobil cihazlara yönelik özelliklere ihtiyacınız varsa Android için Google Haritalar intent'lerini veya iOS için Google Haritalar URL şemasını kullanın.
Haritalar URL'leri: kurulum
- Kullanım ilişkilendirmesi: Haritalar URL'lerine isteğe bağlı
utm_source(uygulamanızın adı) veutm_campaign(kullanıcının amaçlanan işlemi, örneğinplace_details_search) sorgu parametrelerini ekleyin. - Başlayın: Haritalar URL'lerini ayarlama
Haritalar URL'leri: İlgili ürünler
- Genellikle birlikte kullanıldığı API: Places API (Yeni)
Haritalar URL'leri: Sık yapılan yanlışlar
- Sorun:
queryparametresinde yalnızca enlem/boylam içeren bir arama URL'si, haritada veya yan panelde raptiye gösterir ancak yer ayrıntılarını göstermez. Düzeltme: Belirli bir yerin ayrıntılarını göstermek içinquery=PLACE_NAME,ADDRESSkullanın veyaqueryile birliktequery_place_idekleyin. /maps/documentation/urls/get-started adresini inceleyin. - Sorun: Yer kimliği parametreleri (
query_place_id,origin_place_id,destination_place_id,waypoint_place_ids) tek başına çalışmaz. Düzeltme: Bir yer kimliği parametresi ilettiğinizde her zaman eşleşen temel parametreyi (query,origin,destinationveyawaypoints) ekleyin. /maps/documentation/urls/get-started adresini inceleyin. - Sorun:
waypointsparametresi, yol noktalarını desteklemeyen ve platforma bağlı sayı sınırları olan Google Haritalar ürünlerinde yoksayılır.dir_action=navigateise navigasyonun kullanılamadığı yerlerde yoksayılır. Düzeltme: Mobil tarayıcılarda açılan bağlantılar için en fazla üç yol noktası kullanın (diğer durumlarda dokuz) vewaypointsveyadir_action=navigateparametrelerinin her Google Haritalar ürününde ya da rotasında çalışacağını varsaymayın. /maps/documentation/urls/get-started#directions-action adresini inceleyin. - Sorun: Haritalar ve Street View aynı
@uç noktasını paylaştığından, doğru işlem içermeyen bir harita URL'si haritayı görüntülemeyebilir. Düzeltme: Harita görünümleri içinmap_action=map, Street View panoramaları içinmap_action=panodeğerini ayarlayın. /maps/documentation/urls/get-started adresini inceleyin. - Sorun: Haritalar URL'sinde
api=1eksikse tüm parametreler yoksayılır ve Google Haritalar varsayılan görünümünü açar. Düzeltme: Her Haritalar URL'sineapi=1parametresini ekleyin (1, geçerli tek değerdir). /maps/documentation/urls/get-started#forming-the-url adresini inceleyin.