Google Haritalar bağlantısı

Places API (New), çeşitli yöntemlerle yer verileri için istekleri kabul eder. Places API (Yeni) yanıtı; konum verileri ve görüntüler, coğrafi konumlar ve önemli yerler dahil olmak üzere bir yerle ilgili verileri içerir.

Text Search (New), Yakında Arama (New) ve Yer Ayrıntıları (New) yanıtları, Google Haritalar bağlantıları da içerebilir. Kullanıcılarınız, yanıttaki bir yer hakkında daha fazla bilgi görmek için bu Google Haritalar bağlantılarına göz atabilir.

Örneğin, İstanbul'daki havaalanlarını aradığınızı varsayalım. Yanıt, yerler listesinde San Francisco Uluslararası Havaalanı'nı (SFO) içerir. Yanıttaki SFO için Place nesnesi, Google Haritalar'ı açmak için Google Haritalar bağlantılarını içeren googleMapsUri alanını, yerin yol tariflerini, yerle ilgili yorumları ve yer fotoğraflarını ekler.

Place nesnesine eklenen bağlantıların yanı sıra googleMapsUri alanı, yanıttaki Reviews ve Photos nesnelerine de eklenir:

• Reviews.googleMapsUri: Yorumun Google Haritalar bağlantısını içerir. Böylece yorumu tarayıcıda görüntüleyebilirsiniz.

• Photos.googleMapsUri: Fotoğrafın Google Haritalar bağlantısını içerir. Böylece fotoğrafı tarayıcıda görüntüleyebilirsiniz.

API Gezgini, bu yeni seçenekleri tanıyabilmeniz için canlı istekler göndermenize olanak tanır:

Deneyin.

Bir yer için desteklenen Google Haritalar bağlantıları

Aşağıdaki tabloda, yanıta ekleyebileceğiniz Google Haritalar bağlantıları gösterilmektedir:

Places yanıtındaki tüm bağlantıları dahil etme

Yerler yanıtındaki bağlantılar googleMapsLinks alanında yer alır. Yanıt içinde görünmelerini istiyorsanız isteğin alan maskesine googleMapsLinks alanını eklediğinizden emin olun.

Örneğin, aşağıdaki Text Search (Yeni) isteği, yanıttaki tüm Haritalar bağlantılarını içerir:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

Yanıt şu biçimdedir:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

Yanıta belirli bir bağlantı ekleme

Yanıtta tüm bağlantıları döndürmeniz gerekmez. Örneğin, yanıtta yalnızca fotoğraf bağlantısının yer almasını istiyorsanız alan maskesini yalnızca photosUri alanını içerecek şekilde aşağıdaki gibi değiştirin:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Yanıta yol tarifini ekle

Tüm Places yöntemleri, yanıtta yol tarifi bağlantısının oluşturulmasını destekler. Mevcut konum başlangıç noktası, yer konumu hedef olarak kullanılır ve seyahat modu sürüş olarak ayarlanır.

Aşağıdaki örnekte, yanıttaki directionsUri alanına Haritalar yol tarifi bağlantısını eklemek için Yakında Arama (Yeni) kullanılmıştır:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

Yorum ve fotoğraf bağlantıları ekleme

Bu sürümde, yanıttaki Reviews ve Photos nesnelerine googleMapsUri alanı eklenmiştir. Bu bağlantılara göz attığınızda yorum veya fotoğraf Google Haritalar'da açılır.

Örneğin, aşağıdaki Metin Arama (Yeni) yanıtında her yer için yorumlar ve fotoğraflar yer alır:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

Yanıtta, yorumlar ve fotoğraflar dizisinin her öğesi, yorumu veya fotoğrafı tarayıcıda açmak için googleMapsUri alanını içerir.

Deneyin.

API Gezgini, API ve API seçeneklerini tanıyabilmeniz için örnek istekler göndermenize olanak tanır.

1. Sayfanın sağ tarafındaki api API simgesini seçin.

2. İsteğe bağlı olarak Standart parametreleri göster'i genişletin ve fields parametresini alan maskesine ayarlayın.

3. İsterseniz İstek gövdesi'ni düzenleyebilirsiniz.

4. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

5. API Gezgini panelinde fullscreen seçeneğini belirleyin.

   API Gezgini penceresini genişletmek için Tam ekran'ı tıklayın.