Google Haritalar bağlantısı

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

Metin Arama (Yeni), Yakınlardaki Arama (Yeni) ve Yer Ayrıntıları (Yeni) özelliklerinin 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'daki San Francisco havaalanlarını aradığınızı varsayalım. Yanıt, yerler listesine İstanbul Sabiha Gökçen Havaalanı'nı (SFO) ekler. Yanıtın SFO için Place nesnesi, Google Haritalar'ı açmak için Google Haritalar bağlantılarını içeren googleMapsUri alanını ekler: yerin yol tarifi, yerin yorumları ve yerin fotoğrafları.

Place nesnesine eklenen bağlantıların yanı sıra googleMapsUri alanı da yanıttaki Reviews ve Photos nesnelerine 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. Bu sayede fotoğrafı tarayıcıda görüntüleyebilirsiniz.

API Gezgini, canlı isteklerde bulunmanıza olanak tanır. Böylece aşağıdaki yeni seçeneklere aşina olabilirsiniz:

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:

Yerler yanıtına tüm bağlantıları dahil et

Yerler yanıtındaki bağlantılar googleMapsLinks alanında yer alır. Yanıt içinde görünmesini istiyorsanız 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ıyor:

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ıtınızda tüm bağlantıları döndürmeniz gerekmez. Örneğin, yanıtta yalnızca fotoğraflar bağlantısının yer almasını istiyorsanız alan maskesini aşağıdaki gibi değiştirerek yalnızca photosUri alanını ekleyin:

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ıtı yönlendirmelerle birlikte ver

Tüm Places yöntemleri, yanıttaki rota bağlantısının oluşturulmasını destekler. Başlangıç noktası olarak mevcut konum, hedef olarak yerin konumu ve ulaşım şekli 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ındaki Yerleri 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

Yorum ve fotoğraf bağlantılarını ekleyin

Bu sürüm, yanıttaki Reviews ve Photos nesnelerine googleMapsUri alanını ekler. 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 aramasında (yeni) yanıttaki her 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ı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çeneklerine alışabilmeniz 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 maskesi olarak ayarlayın.

3. İsteğe bağlı olarak Request body'yi (İstek gövdesi) 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 fullscreen simgesini seçin.

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