Google Haritalar bağlantısı

Places API (Yeni), çeşitli yöntemlerle yer verileri isteklerini kabul eder. Places API (Yeni) yanıtı, bir yerle ilgili verileri (konum verileri ve görüntüleri, coğrafi konumlar ve önemli ilgi alanları dahil) içerir.

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

Örneğin, Kaliforniya, San Francisco'daki havaalanlarını aradığınızı varsayalım. Yanıtta, yerler listesine İstanbul Sabiha Gökçen Havaalanı (SFO) ekleniyor. Yanıttaki SFO için Place nesnesi, Google Haritalar'ı yerde açmak, yere yol tarifi almak, yerin yorumlarını ve yer fotoğraflarını görmek için Google Haritalar bağlantılarını içeren googleMapsUri alanını ekler.

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

  • Reviews.googleMapsUri: Yorumu tarayıcıda görüntüleyebilmeniz için yorumun Google Haritalar bağlantısını içerir.

  • 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çeneklere alışabilmeniz için canlı isteklerde bulunmanıza olanak tanır:

Deneyin.

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

Google Haritalar bağlantısı Açıklama Alan adı
Yer Google Haritalar'ı yerde açma bağlantısı. googleMapsLinks.placeUri
Yol tarifi Yerin yol tarifini Google Haritalar'da açmak için kullanılan bağlantı. googleMapsLinks.directionsUri
Yorum yazın Google Haritalar'da yerle ilgili yorum yazma bağlantısı. googleMapsLinks.writeAReviewUri
Yorumları oku Yerin Google Haritalar yorumlarını gösterme bağlantısı. googleMapsLinks.reviewsUri
Fotoğraflar Google Haritalar'da yerin fotoğraflarını gösterme bağlantısı. googleMapsLinks.photosUri

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

Örneğin, aşağıdaki Metin Arama (Yeni) yanıtında tüm Haritalar bağlantıları yer alır:

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çimde olmalıdır:

{
  "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ıtta tüm bağlantıları döndürmeniz gerekmez. Örneğin, yanıtta yalnızca fotoğraflar bağlantısının olması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 tarifi ekleme

Tüm Places yöntemleri, yanıtta yol tarifi bağlantısı oluşturmayı destekler. Kaynak olarak geçerli konum, hedef olarak yer konumu ve seyahat modu olarak araba kullanılır.

Aşağıdaki örnekte, yanıttaki harita yol tarifi bağlantısını directionsUri alanına eklemek için Yakında Arama (Yeni) kullanılı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

Bu sürüm, yanıttaki Reviews ve Photos nesnelerine googleMapsUri alanını ekler. Bu bağlantılara göz atıldığında yorum veya fotoğraf Google Haritalar'da açılır.

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

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ıtın yorumlar ve fotoğraflar dizisindeki her öğe, yorumu veya fotoğrafı tarayıcıda açmak için googleMapsUri alanını içerir.

Deneyin.

API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

  1. Sayfanın sağ tarafındaki 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. İsteğe bağlı olarak Request body (İstek gövdesi) bölümünü düzenleyin.

  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 simgesini seçin.

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