Varış noktası arama

Avrupa Ekonomik Alanı (AEA) geliştiricileri

A Destination bir kullanıcının ulaşmak veya gezinmek istediği belirli bir konumu veya yeri ifade eder. Destination ayrıca konum veya yerle ilgili bir bilgi koleksiyonunu da içerir. Örneğin, navigasyon noktaları, önemli yerler, girişler ve bina ana hatları.

Geocoding API'nin SearchDestinations yöntemi, adres, yer kimliği veya enlem ve boylam koordinatları gibi farklı giriş ölçütlerine göre çeşitli hedefler hakkında ayrıntılı bilgi almanıza olanak tanır.

Hedef arama isteği

Hedef arama isteği şu biçimde bir URL'ye yapılan HTTP POST isteğidir:

https://geocode.googleapis.com/v4/geocode/destinations

JSON istek gövdesindeki veya üstbilgilerdeki tüm parametreleri POST isteğinin bir parçası olarak iletin. Örneğin:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Hedef aramak için konumu 3 şekilde belirtebilirsiniz:

  • Adres
  • Yer kimliği
  • Enlem ve boylam koordinatları

Adrese göre hedef arama

Adresi yapılandırılmamış bir dize olarak belirtebilirsiniz. Adres coğrafi kodlaması, enlem ve boylam koordinatlarını ya da adresleri temsil etmeyen diğer yapılandırılmamış dizeleri çözmez. Bu tür dizeleri kullanan istekler desteklenmez ve hata yanıtlarına veya belirtilmemiş davranışlara yol açabilir. Desteklenmeyen sorgulara örnek olarak aşağıdakiler verilebilir:

Sorgu türü Örnek
Enlem ve boylam koordinatları. Bunun yerine konum sorgusu kullanın. "37.422131,-122.084801"
Tek bir sorguda birden fazla yerin, yolun veya şehrin adı gibi çok fazla kavram ya da kısıtlama olması "Market Street San Francisco San Jose Airport"
Posta adresi öğeleri Google Haritalar'da gösterilmiyor "C/O John Smith 123 Main Street"
"P.O. Box 13 San Francisco"
İşletmelerin, zincirlerin veya kategorilerin adları, bu öğelerin bulunmadığı konumlarla birlikte kullanıldığında "Tesco near Dallas, Texas" (Teksas, Dallas yakınlarındaki Tesco)
Birden fazla yorumu olan belirsiz sorgular "Şarj cihazı terk etme"
Artık kullanılmayan eski adlar "Middlesex United Kingdom"
Coğrafi olmayan öğeler veya amaç "Ventura Limanı'nda kaç tekne var?"
Resmi olmayan veya kişisel adlar "The Jenga"
"The Helter Skelter"
Büyük siyasi birimler (şehirler, eyaletler, ülkeler) "New York City"
"California"
"USA"
Belirli adreslerin olmadığı rotalar "1st Ave., NYC, NY"
"I-95" 
curl -X POST -d '{
  "addressQuery": {
    "addressQuery": "601 S Bernardo Ave, Sunnyvale, CA 94087, USA"
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

veya postalAddress olarak:

curl -X POST -d '{
  "addressQuery": {
    "address": {
      "addressLines": ["601 S Bernardo Ave"],
      "locality": "Sunnyvale",
      "postalCode": "94087",
      "administrativeArea": "CA",
      "regionCode": "US"
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Genellikle bir HTML formunda yakalanan adres bileşenlerini işlerken postalAddress biçimini kullanırsınız.

Yer kimliğine göre hedef arama

Yer kimliği sağlayarak bir hedefi alabilirsiniz:

curl -X POST -d '{
  "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

Desteklenen yer kimlikleri

Hedef arama yöntemi, belirli ve gezilebilir hedefleri temsil eden yer kimlikleriyle en iyi şekilde çalışır. establishment, point_of_interest, premise, street_address ve subpremise gibi türler için yer kimlikleri genellikle desteklenir. Adres aralıklarından (ör. "10-20 Main St"), belirli bir numarası olmayan rota bölümlerinden veya artı kodlarından çıkarılanlar gibi ayrı konumları temsil etmeyen yer kimlikleri desteklenmez. Alanı çok büyük olan sonuçlar (ör. "Pasifik Okyanusu") için yer kimlikleri de desteklenmez.

Places API Autocomplete (Yeni) ile Arama Hedefleri'ni kullanma

Uyumluluğu sağlamak için Arama Hedefleri ile kullanılacak Yer Kimliklerini bulmak üzere Places API Autocomplete (Yeni)'i kullanın. Otomatik tamamlama özelliğini kullanırken includedPrimaryTypes parametresini kullanarak sonuçları türe göre filtrelemeniz gerekir. Aşağıdaki önerilen filtre kullanılarak Otomatik Tamamlama tarafından döndürülen yer kimlikleri, Arama Hedefleri tarafından desteklenir:

"includedPrimaryTypes": [ "establishment", "point_of_interest", "premise", "street_address", "subpremise" ]

Ayrıca, otomatik tamamlama isteğinizde include_pure_service_area_businesses işaretini true olarak ayarlamamalısınız.

Konuma göre hedef arama

Enlem ve boylam koordinatlarını girerek bir hedef arayabilirsiniz:

curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    }
  }
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: *" \
https://geocode.googleapis.com/v4/geocode/destinations

İstek göndermek için OAuth kullanma

Geocoding API v4, kimlik doğrulama için OAuth 2.0'ı destekler. Coğrafi Kodlama API'si ile OAuth'u kullanmak için OAuth jetonuna doğru kapsam atanmalıdır. Geocoding API, Destinations yöntemiyle kullanılmak üzere aşağıdaki kapsamları destekler:

  • https://www.googleapis.com/auth/maps-platform.geocode — Tüm Geocoding API yöntemleriyle kullanılabilir.

Ayrıca, tüm Geocoding API yöntemleri için genel https://www.googleapis.com/auth/cloud-platform kapsamını kullanabilirsiniz. Bu kapsam, tüm yöntemlere erişime izin veren genel bir kapsam olduğundan geliştirme sırasında kullanışlıdır ancak üretimde kullanışlı değildir.

Daha fazla bilgi ve örnek için OAuth'u kullanma başlıklı makaleyi inceleyin.

Hedef arama yanıtı

Arama Hedefleri yanıtı, konum hakkında zengin ve yakın çevreye özel bağlam bilgisi sağlar.

Arama Hedefleri yanıtındaki PlaceView nesneleri (ör. primary, containingPlaces içindeki öğeler ve landmarks), yer türünü belirtmek için alanları kullanır:

  • types: Yer türlerini belirten bir dizeler dizisi.
  • primaryType: Yerleşim yerinin birincil türünü belirten bir dize.

Hem types hem de primaryType için olası dize değerleri, Yer Türleri (Yeni) sayfasındaki A ve B tablolarından alınır.

Bu bölümde, temel yanıt alanları açıklanmaktadır. Tüm yanıt alanları hakkında ayrıntılı bilgi için API Referansı'na bakın.

primary

İstekteki sorgu tarafından tanımlanan ana yer.

addressComponents

Bu adres için geçerli olan ayrı bileşenleri içeren bir dizi.

Her adres bileşeni genellikle aşağıdaki alanları içerir:

  • types[], adres bileşeninin türünü belirten bir dizidir. Desteklenen türlerin listesine bakın.
  • longText, adres bileşeninin Geocoder tarafından döndürülen tam metin açıklaması veya adıdır.
  • shortText, varsa adres bileşeninin kısaltılmış metin adıdır. Örneğin, Alaska eyaletinin adres bileşeninde iki harfli posta kısaltması kullanılarak longText "Alaska" ve shortText "AK" olabilir.
  • languageCode, bu bileşeni biçimlendirmek için kullanılan dildir (CLDR gösterimiyle).

containingPlaces

Birincil hedefin parçası olduğu daha büyük kuruluşlar (örneğin, bir mağazanın bulunduğu alışveriş merkezi).

subDestinations

Birincil hedefteki daha ayrıntılı konumlar (örneğin, bir binadaki daireler).

entrances

entrances[] dizisindeki nesnelerde aşağıdaki alanlar bulunur:

  • location

    Bir giriş ve çıkış noktasının konumunu tanımlayan tek bir enlem/boylam koordinat çifti.

  • entrance_tags[]

    Girişin özelliklerini açıklayan bir giriş etiketleri dizisi. Aşağıdaki değer desteklenir:

    • "PREFERRED"

    Bu girişin, döndürülen yere fiziksel erişim sağlama olasılığının yüksek olduğunu gösterir. Bir yerin birden fazla tercih edilen girişi olabilir. Bir girişte bu etiket yoksa giriş fiziksel olarak aynı binada bulunuyor ancak mekana erişim sağlamıyor olabilir.

    Örneğin, döndürülen yer bir alışveriş merkezindeki bir restoransa "PREFERRED" girişleri, restoranın kendi girişleri olur. Döndürülen diğer girişler ise binanın diğer girişleri (ör. alışveriş merkezindeki diğer restoranların girişleri) olur.

    Döndürülen yerin kendisi bir binaysa "PREFERRED" girişleri, binanın "ana" kısmına giden girişler olur. Örneğin, bir alışveriş merkezinde "PREFERRED" girişleri, ana fuaye alanına erişime izin veren girişlerdir. Ancak bir giriş yalnızca binanın yan tarafındaki bir mağazaya erişim sağlıyorsa bu giriş "PREFERRED" girişi olmaz.

  • streetViewThumbnail ve streetViewAnnotation

    Street View Static API'nin parametreleri sayesinde bu konumlarla ilgili görüntüleri gösterebilirsiniz. Bu alanlar hakkında daha fazla bilgi edinin.

structureType

Bu yerin temsil ettiği yapı türü.

  • POINT

    Nokta konumu.

  • SECTION

    Bir binanın alt bölümü.

  • BUILDING

    Bir bina.

  • GROUNDS

    Genellikle üniversite kampüsü, apartman kompleksi veya alışveriş merkezi gibi birden fazla binanın bulunduğu geniş bir alan.

Coğrafi kodlama yanıtındaki navigationPoints alanı, yere gitmek için kullanışlı olan noktaların listesini içerir. Daha net bir ifadeyle, bu noktalar, bir yol ağında bir yerden başka bir yere rota oluşturulurken başlangıç veya bitiş noktası olarak kullanılmalıdır.

Her gezinme noktası aşağıdaki değerleri içerir:

  • navigationPointToken, navigationPoints alanındaki bağlamsal bilgileri içeren bir jetondur. Bu jetonu, uygulamanızdaki rota oluşturma ve nehir deneyimini iyileştirmek için rota oluşturma ve gezinme API'lerine gönderebilirsiniz. Daha fazla bilgi için Gezinme noktası jetonlarını kullanarak rota oluşturma başlıklı makaleyi inceleyin.
  • location, gezinme noktasının enlem ve boylam değerini içerir. Bu konum her zaman yol ağına çok yakındır ve bir yere gitmek veya bir yerden gelmek için ideal bir durma ya da başlangıç noktasıdır. Nokta, yerin bulunduğu yol tarafını net bir şekilde işaretlemek için kasıtlı olarak yolun merkez çizgisinden biraz uzağa yerleştirilir.
  • travelModes, gezinme noktasına erişilebilen seyahat modlarının listesidir:
    • "DRIVE", arabayla yol tariflerine karşılık gelen ulaşım şeklidir.
    • "WALK", yaya yol tariflerine karşılık gelen ulaşım şeklidir.
  • usages, gezinme noktası tarafından desteklenen kullanımların listesidir. Kullanımlar şu şekilde olabilir:
    • "DROPOFF"
    • "PICKUP"
    • "PARKING"

Teslim alma ve bırakma işlemleri için seyahat modunun DRIVE olduğu ve kullanımın PICKUP veya DROPOFF olduğu gezinme noktasını kullanın. Teslim alma veya bırakma noktaları yoksa en üstteki sürüş navigasyon noktasını kullanın.

  • altitude_meters, WGS-84 elipsoidine göre gezinme noktasının metre cinsinden yüksekliğini içerir. Dikey olarak üst üste yerleştirilmiş yol segmentlerinin olduğu durumlarda, sisteminizin gideceği en iyi yol segmentini seçmek için altitude_meters alanını kullanın.

landmarks

Kullanıcıların varış noktasının çevresini anlamasına yardımcı olacak, yakındaki önemli yerler.

arrivalSummary

Varış konusunda yardımcı olacak yapay zeka destekli analizler. Yapay zeka destekli özetler bölümünü inceleyin.

parkingOptions

Ayrıntılı otopark bilgileri

Yanıt biçimi

SearchDestinations, aşağıdaki JSON biçiminde bir SearchDestinationsResponse döndürür:

{
  "destinations": [
    {
      "primary": {
        "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w",
        "displayName": {
          "text": "Arby's",
          "languageCode": "en"
        },
        "primaryType": "fast_food_restaurant",
        "types": [
          "fast_food_restaurant",
          "sandwich_shop",
          "deli",
          "meal_takeaway",
          "food_delivery",
          "american_restaurant",
          "restaurant",
          "food_store",
          "store",
          "food",
          "point_of_interest",
          "establishment"
        ],
        "formattedAddress": "Arby's, 601 S Bernardo Ave, Sunnyvale, CA 94087, USA",
        "postalAddress": {
          "regionCode": "US",
          "languageCode": "en",
          "postalCode": "94087",
          "administrativeArea": "CA",
          "locality": "Sunnyvale",
          "addressLines": [
            "601 S Bernardo Ave"
          ]
        },
        "structureType": "BUILDING",
        "location": {
          "latitude": 37.3734545,
          "longitude": -122.05693269999998
        },
        "displayPolygon": {
          "type": "Polygon",
          "coordinates": [
            [
              [
                -122.056930138027,
                37.3735253692531
              ],
              [
                -122.056960139391,
                37.3735372663597
              ],
              [
                -122.056994129366,
                37.3734828786847
              ],
              [
                -122.056969677395,
                37.3734731161089
              ],
              [
                -122.057061762447,
                37.3733261309656
              ],
              [
                -122.056979388817,
                37.3732935577128
              ],
              [
                -122.056798860285,
                37.3735818838642
              ],
              [
                -122.056875858081,
                37.3736121235316
              ],
              [
                -122.056930138027,
                37.3735253692531
              ]
            ]
          ]
        }
      },
      "containingPlaces": [
        {
          "place": "places/ChIJYfdAFum2j4ARIcL2tjME3Sw",
          "displayName": {
            "text": "Cherry Chase Shopping Center",
            "languageCode": "en"
          },
          "primaryType": "shopping_mall",
          "types": [
            "shopping_mall",
            "point_of_interest",
            "establishment"
          ],
          "formattedAddress": "Cherry Chase Shopping Center, 663 S Bernardo Ave, Sunnyvale, CA 94087, USA",
          "postalAddress": {
            "regionCode": "US",
            "languageCode": "en",
            "postalCode": "94087-1020",
            "administrativeArea": "CA",
            "locality": "Sunnyvale",
            "addressLines": [
              "663 S Bernardo Ave"
            ]
          },
          "structureType": "GROUNDS",
          "location": {
            "latitude": 37.3731231,
            "longitude": -122.0578211
          },
          "displayPolygon": {
            "type": "Polygon",
            "coordinates": [
              [
                [
                  -122.057112227103,
                  37.3714618008523
                ],
                [
                  -122.057076849821,
                  37.3715743611411
                ],
                [
                  -122.056963607756,
                  37.3719081793948
                ],
                [
                  -122.056865279559,
                  37.3722026053835
                ],
                [
                  -122.056687872374,
                  37.3727258358476
                ],
                [
                  -122.056580005889,
                  37.3730511370747
                ],
                [
                  -122.056498845827,
                  37.3732994782583
                ],
                [
                  -122.056338259713,
                  37.3737878663325
                ],
                [
                  -122.056618678291,
                  37.373887693582
                ],
                [
                  -122.056912102521,
                  37.3740010327191
                ],
                [
                  -122.057532418159,
                  37.3742476426462
                ],
                [
                  -122.057673926626,
                  37.3742441740031
                ],
                [
                  -122.057735663106,
                  37.3742328516943
                ],
                [
                  -122.057766531332,
                  37.3742220604378
                ],
                [
                  -122.057797572967,
                  37.37420520725
                ],
                [
                  -122.057828267759,
                  37.3741852342085
                ],
                [
                  -122.058060299297,
                  37.3740060842535
                ],
                [
                  -122.058199726081,
                  37.3737861673422
                ],
                [
                  -122.05836707267,
                  37.373524542556
                ],
                [
                  -122.058569622393,
                  37.3732018598683
                ],
                [
                  -122.0587638478,
                  37.3728890198039
                ],
                [
                  -122.058934661823,
                  37.3726036257774
                ],
                [
                  -122.059164956851,
                  37.3722498383629
                ],
                [
                  -122.058997784906,
                  37.3721804442035
                ],
                [
                  -122.057936479838,
                  37.3717605636234
                ],
                [
                  -122.057495827092,
                  37.3715860151634
                ],
                [
                  -122.057112227103,
                  37.3714618008523
                ]
              ]
            ]
          }
        }
      ],
      "landmarks": [
        {
          "place": {
            "place": "places/ChIJXXTe7Oi2j4ARoMTA-D6Hjpg",
            "displayName": {
              "text": "Chase Bank",
              "languageCode": "en"
            },
            "primaryType": "bank",
            "types": [
              "bank",
              "atm",
              "finance",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Chase Bank, 1234 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1234 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.373579,
              "longitude": -122.05752700000001
            }
          },
          "relationalDescription": {
            "text": "Near Chase Bank",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 61.182193756103516,
          "travelDistanceMeters": 63.075645446777344
        },
        {
          "place": {
            "place": "places/ChIJteQ0Fum2j4ARGi3tqK4Zm14",
            "displayName": {
              "text": "Safeway",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "butcher_shop",
              "florist",
              "deli",
              "supermarket",
              "bakery",
              "food_delivery",
              "market",
              "manufacturer",
              "food_store",
              "store",
              "food",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Safeway, 639 S Bernardo Ave, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "639 S Bernardo Ave"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3727912,
              "longitude": -122.0581172
            }
          },
          "relationalDescription": {
            "text": "Around the corner from Safeway",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL",
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 158.65606689453125,
          "travelDistanceMeters": 131.1669921875
        },
        {
          "place": {
            "place": "places/ChIJu-PSYui2j4ARNiwOwBApGqk",
            "displayName": {
              "text": "Oil Changers",
              "languageCode": "en"
            },
            "types": [
              "car_repair",
              "service",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Oil Changers, 1240 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1240 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3743054,
              "longitude": -122.0584272
            }
          },
          "relationalDescription": {
            "text": "Down the road from Oil Changers",
            "languageCode": "en"
          },
          "tags": [
            "ARRIVAL"
          ],
          "straightLineDistanceMeters": 140.52459716796875,
          "travelDistanceMeters": 143.24220275878906
        },
        {
          "place": {
            "place": "places/ChIJKRbl5oG3j4ARwuvPGUmtCj0",
            "displayName": {
              "text": "Apni Mandi Farmers Market Sunnyvale",
              "languageCode": "en"
            },
            "primaryType": "grocery_store",
            "types": [
              "grocery_store",
              "cake_shop",
              "supermarket",
              "asian_grocery_store",
              "indian_restaurant",
              "meal_takeaway",
              "bakery",
              "manufacturer",
              "wholesaler",
              "restaurant",
              "food_store",
              "store",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Apni Mandi Farmers Market Sunnyvale, 1111 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1056",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1111 W El Camino Real"
              ]
            },
            "structureType": "POINT",
            "location": {
              "latitude": 37.3737199,
              "longitude": -122.0522958
            }
          },
          "relationalDescription": {
            "text": "Near Apni Mandi Farmers Market Sunnyvale",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 410.37435913085938,
          "travelDistanceMeters": 479.49893188476562
        },
        {
          "place": {
            "place": "places/ChIJ8enMlui2j4AR2xXK5EHDhBs",
            "displayName": {
              "text": "Starbird Chicken",
              "languageCode": "en"
            },
            "primaryType": "chicken_restaurant",
            "types": [
              "chicken_restaurant",
              "fast_food_restaurant",
              "restaurant",
              "food",
              "point_of_interest",
              "establishment"
            ],
            "formattedAddress": "Starbird Chicken, 1241 W El Camino Real, Sunnyvale, CA 94087, USA",
            "postalAddress": {
              "regionCode": "US",
              "languageCode": "en",
              "postalCode": "94087-1028",
              "administrativeArea": "CA",
              "locality": "Sunnyvale",
              "addressLines": [
                "1241 W El Camino Real"
              ]
            },
            "structureType": "BUILDING",
            "location": {
              "latitude": 37.3746764,
              "longitude": -122.05708860000001
            },
            "displayPolygon": {
              "coordinates": [
                [
                  [
                    -122.057003840785,
                    37.3747648209809
                  ],
                  [
                    -122.057136852459,
                    37.3747919153144
                  ],
                  [
                    -122.057205005705,
                    37.3745815131859
                  ],
                  [
                    -122.057071994114,
                    37.3745544186944
                  ],
                  [
                    -122.057003840785,
                    37.3747648209809
                  ]
                ]
              ],
              "type": "Polygon"
            }
          },
          "relationalDescription": {
            "text": "Near Starbird Chicken",
            "languageCode": "en"
          },
          "tags": [
            "ADDRESS"
          ],
          "straightLineDistanceMeters": 87.348007202148438,
          "travelDistanceMeters": 214.08084106445312
        }
      ],
      "entrances": [
        {
          "location": {
            "latitude": 37.3735328,
            "longitude": -122.05694879999999
          },
          "tags": [
            "PREFERRED"
          ],
          "place": "places/ChIJY8sv5-i2j4AR_S6BlDDR42w"
        }
      ],
      "navigationPoints": [
        {
          "navigationPointToken": "ChIJeMt61tqvQkARWT2716SDXsASEgljyy_n6LaPgBH9LoGUMNHjbBoSCWPLL-foto-AEf0ugZQw0eNsIhIJhf5y6ei2j4ARz7yBW5KAPI4",
          "location": {
            "latitude": 37.3738659,
            "longitude": -122.05693620000001
          },
          "travelModes": [
            "DRIVE",
            "WALK"
          ],
          "usages": [
            "PARKING"
          ]
        }
      ]
    }
  ]
}

Gerekli parametreler

  • Hedef için aranacak adresi, yeri veya konumu belirten aşağıdaki 3 parametreden biri API isteğinde olmalıdır:
    • addressQuery: Aranacak adres.
    • place: Aranacak yerin yer kimliği.
    • locationQuery - aranacak konumun enlem ve boylam koordinatları.

  • FieldMask

    Yanıt alan maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. Yanıt alan maskesini, $fields veya fields URL parametresini ya da X-Goog-FieldMask HTTP üst bilgisini kullanarak yönteme iletin. Örneğin, aşağıdaki istek yalnızca birincil hedefin girişlerini, gezinme noktalarını ve yer kimliğini döndürür.

      curl -X POST -d '{"place": "places/ChIJG3kh4hq6j4AR_XuFQnV0_t8"}' \
    -H "X-Goog-Api-Key: API_KEY" \
    -H "Content-Type: application/json" \
    -H "X-Goog-FieldMask: destinations.entrances,destinations.navigationPoints,destinations.primary.place" \
    https://geocode.googleapis.com/v4/geocode/destinations

    Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini atlarsanız yöntem hata döndürür. Tüm alanları döndürmek için alan maskesini * olarak ayarlayın. Daha fazla bilgi için Döndürülecek alanları seçme bölümüne bakın.

İsteğe bağlı parametreler

  • travelModes

    Hangi tür navigationPoints öğelerinin döndürüleceğini belirtir. Diğer seyahat modlarına ait gezinme noktaları filtrelenir. travelModes ayarlanmamışsa tüm ulaşım şekillerinin gezinme noktaları döndürülebilir.

  • languageCode

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste kapsamlı olmayabilir.
    • languageCode sağlanmazsa API varsayılan olarak en değerini kullanır. Geçersiz bir dil kodu belirtirseniz API INVALID_ARGUMENT hatası döndürür.
    • API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili göz önünde bulundurarak sokak adreslerini yerel dilde döndürür. Gerekirse adresler, kullanıcı tarafından okunabilir bir alfabeye çevrilir. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen aynı dilde döndürülür.
    • Bir ad tercih edilen dilde kullanılamıyorsa API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar.

  • regionCode

    Bölge kodu, iki karakterli CLDR kodu değeri olarak. Varsayılan değer yoktur. Çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır.

    Bir adresin coğrafi kodlaması yapılırken (ileri coğrafi kodlama) bu parametre, hizmetin sonuçlarını belirtilen bölgeyle sınırlayabilir ancak tamamen kısıtlayamaz. Bir konum veya yer için coğrafi kodlama yapılırken (tersine coğrafi kodlama veya yer coğrafi kodlama) bu parametre, adresin biçimlendirilmesi için kullanılabilir. Bu parametre, her durumda geçerli yasaya bağlı olarak sonuçları etkileyebilir.

  • placeFilter

    locationQuery Arama sonuçlarını, yalnızca binalar olan hedefleri veya yalnızca açık adresleri olan hedefleri döndürme gibi gereksinimlerinizi karşılayacak şekilde filtrelemenizi sağlar.

    Yapısal ayrıntı düzeyine göre filtreleme

    structureType filtresi, sorgu tarafından döndürülen yapı türlerini belirtmenize olanak tanır:

    • Binaları Ayırma: Haritada bina ana hatlarını göstermek veya belirli bir yapı hakkında ayrıntılı bilgi edinmek için "structureType": "BUILDING" simgesini kullanın.
    • Kompleksleri Anlama: Birincil sonucun genel alan olmasını sağlamak için "structureType": "GROUNDS" simgesini kullanın. Bu özellik, üniversite kampüsleri veya alışveriş merkezleri gibi daha büyük alanlar için sorgu yaparken kullanışlıdır.
    • Birimlere/Bölümlere Odaklanma: Bir binadaki bölümleri tanımlamak için "structureType": "SECTION" kullanın.

    Faydalı adresler sağlama

    Bazı yerlerin açık adresleri yoktur. addressability filtresi, sonuçlarınızdaki adreslerin kalitesini kontrol etmenize yardımcı olur:

    • Net Birincil Adres Gerektir: Ana hedef sonucunun her zaman sokak düzeyinde bir adrese veya ada sahip olmasını sağlamak için "addressability": "PRIMARY" kullanın. Bu, net bir adresin önemli olduğu gezinme veya görüntüleme amaçları için yararlıdır.
    • Alt Hedeflerde Adreslere İzin Ver: Birincil yerin adresi olmayabilir ancak içindeki birimlerin (ör. bir binadaki daireler) adresi olabilir. Bu gibi durumlarda "addressability": "WEAK", en azından birincil yerin veya alt hedeflerinden birinin adresinin olmasını sağlar.
    • Herhangi bir sonuç: Adres varlığı kullanım alanınızla alakalı değilse "addressability": "ANY" kullanın. Bu yöntem, yalnızca bina ana hatları ve gezinme noktaları gibi geometrik özelliklere ihtiyacınız olduğunda kesinlikle önerilir. Bu sayede, sonuçların doğruluğu artar.
    Örnek: Adreslenebilir binalar için filtreleme 
    curl -X POST -d '{
  "locationQuery": {
    "location": {
      "latitude": 37.37348780,
      "longitude": -122.05678064
    },
    "placeFilter": {
      "structureType": "BUILDING",
      "addressability": "PRIMARY"
    }
  },
  "languageCode": "en"
}' \\
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \\
-H "X-Goog-FieldMask: place" \\
https://geocode.googleapis.com/v4/geocode/destinations